FF 


2014 年 年 底 ， 我 在 从 事 Openstack 工 作 两 年 多 之 后 第 一 次 在 北京 环球 贸易 中 心 接触 到 了 李 华 和 他 们 的 海 云 团 队 ， 之 后 我 们 团队 与 海 云 也 有 过 多 次 技术 交流 ， 我 个 人 也 聆听 过 李 华 对 Openstack 现 实 困 境 
和 未 来 发 展 的 各 种 看 法 。 我 被 李 华 和 他 们 创业 团队 的 远见 ， 以 及 在 云 计算 事业 里 的 决断 气 是 而 折服 ， 也 为 他 们 在 Openstack 领 域 的 低调 实干 精神 感到 钦佩 。 


后 来 ， 由 于 英特尔 公司 对 海 云 捷 迅 公司 的 投资 关系 ， 我 们 英特尔 研发 团队 与 海 云 创业 团队 形成 了 稳定 的 合作 模式 ， 建 立 了 稳固 的 合作 关系 ， 在 工作 中 发 展 了 深厚 的 友谊 。 我 们 主要 在 上 游 社 区 负责 英 特 
尔 平台 相关 的 功能 开发 ， 而 海 云 除 了 开发 Openstack 功 能 之 外 ， 更 多 是 要 在 客户 那 边 负 责 OpenSstack 部 署 和 实施 。 也 正 是 因为 这 样 ， 我 们 也 从 海 云 那 边 得 到 了 第 一 手 客户 需求 信息 和 部 署 实施 经 验 。 


2015 年 年 中 ， 李 华 毫 不 音 背 地 送 给 我 一 本 内 部 交流 资料 用 于 学 习 。 该 内 部 交流 资料 是 培训 | 企业 运 维 人 人员， 如何 一 步 一 步 在 企业 内 部 用 OpenStack 部 署 工 具 ， 从 零 开 始 搭 建 去 计算 系统 的 ， 内 容 基本 覆盖 
了 所 有 OpenStack 关 键 项 目的 基础 用 法 ， 非 常 接地 气 。 对 于 我 这 样 一 名 以 OpenStack 代 码 开 发 出 身 的 开发 人 员 来 说 ， 受 益 良 多 。 而 且 我 们 研发 团队 围绕 着 固定 几 个 关键 项 目 进行 开发 ， 很 难 接触 到 
Openstack 全 局 ， 也 很 少 有 机 会 接触 到 为 支撑 一 个 企业 内 部 私有 云 所 需 的 所 有 Openstack 组 件 的 工作 原理 ， 这 本 内 部 交流 资料 使 我 拓宽 了 视野 ， 增 长 了 见识 。 


绍 ， 比 如 KVM、Open vswitch 和 Ceph 等 ， 甚 至 还 有 海 云 部 署 案例 分 析 。 这 本 书 的 内 容 比 我 当年 拿 到 的 内 部 交流 资料 的 内 容 还 要 丰富 和 完整 ， 在 感谢 海 云 对 Openstack 社 区 慷慨 分 享 的 同时 ， 我 相信 读者 一 
定 能 从 书 中 学 到 更 全 面 、 更 深入 的 Openstack 知 识 ， 并 运用 到 自己 的 生产 部 署 和 实践 开发 中 。 


ZR 博士 
OpenStack 基 金 会 个 人 独立 董事 


英特尔 开源 技术 中 心 网 络 和 存储 部 门 开 发 经 理 


为 什么 写 这 本 书 
从 2010 年 7 月 至 今 ，OpenStack 已 经 发 布 了 15 个 版 本 ， 并 成 为 云 计 算 基础 架构 (laaS) 的 事实 标准 。 目 前 OpenStack 也 被 国内 企业 接受 ,包括 中 国 移动 通信 集团 公司 、 中 国电 信和 集团 公司 、 中 国 银联 股 
份 有 限 公司 、 中 国 国 电 集 团 公 司 等 都 在 直接 或 间接 使 用 OpenStack。 


随 着 云 的 普及 ， 越 来 越 多 的 业务 部 署 并 运行 在 OpenStack 云 中 ， 原 生 的 OpenStack 的 界面 及 功能 已 经 远 远 不 能 满足 需求 ， 有 规模 的 企业 寻求 定制 自己 的 OpenStack， 其 中 包括 界面 的 定制 、 计 算 和 网 络 
等 功能 的 增强 等 。 而 与 OpenStack 相 关 的 创业 公司 经 过 几 年 的 发 展 ， 都 已 经 有 了 自己 成 熟 的 产品 ， 这 些 公司 如 今 不 再 为 温饱 而 四 处 奔波 ， 也 已 经 从 “ 卖 人 ”转向 出 售 自 有 产品 。 随 着 OpenStack 创 业 公司 规 
模 不 断 扩 大 ， 原 有 人 员 远 远 不 能 满足 需求 ， 熟 悉 OpenStack 开 发 的 人 员 更 是 难 寻 ， 除 了 在 “ 云 圈 子 ” 寻 找 人 才 外 ， 很 大 一 部 分 是 从 Java、C++ 等 专业 人 才 中 进行 招聘 ， 这 些 新 人 进入 公司 后 ， 经 过 一 段 时 间 
的 培训 ， 才 能 逐渐 进入 Openstack 开 发 的 角色 。 


缺少 Openstack 开 发 人 员 的 原因 主要 有 以 下 几 方 面 。 

1) 开发 人 员 首先 要 熟悉 Linux 操 作 系 统 ， 然 后 要 熟悉 OpenSstack 的 相关 概念 ， 同 时 需要 具有 Openstack 相 关 安 装 部 署 经 验 。 
2) 开发 人 员 要 有 良好 的 英文 基础 ， 能 够 看 懂 官 方 的 英文 文档 。 

3) OpenStack 的 开发 语言 为 Python， 很 多 高 校 没有 开设 相关 课程 ， 需 要 开发 人 员 自 己 学 习 。 

4) 开源 软件 需要 用 到 很 多 开源 工具 ,包括 Git、Curl、Jenkins 等 ， 这 些 工具 都 需要 开发 人 员 掌 握 。 


这 些 条 件 和 要 求 整合 到 一 起 ， 难 度 就 陡然 增加 了 ， 一 名 普通 计算 机 专业 的 本 科 毕 业 生 要 从 事 OpenStack 开 发 相关 工作 ， 至 少 要 在 OpenStack 的 开发 企业 中 培训 | 学 习 3 个 月 左右 ; 而 一 个 云 计算 的 开发 企 
每 次 招收 的 毕业 生 、 培 养 的 新 人 是 有 限 的 ， 加 在 一 起 不 超过 干 人 ， 这 些 人 员 远 远 不 能 满足 市 场 的 需求 。 由 此 看 来 ，OpenStack 开 发 人 员 还 是 非常 紧缺 的 ， 其 待遇 也 是 很 不 错 的 。 


业 ， 
本 书 的 主要 内 容 和 特色 


本 书 是 根据 北京 海 云 捷 迅 科技 有 限 公 司 内 部 培训 教程 重新 整理 编辑 而 成 ， 内 容 包 括 Python 语 言 基 础 及 开发 优化 的 原则 和 Openstack 组 件 及 开发 方面 的 知识 ， 是 一 本 系统 、 人 全面、 讲解 深入 的 开发 类 书 
籍 ， 值 得 所 有 Python 和 OpenStack 从 业 人 员 学习 参 考 。 本 书 特色 如 下 : 


1) 有 针对 性 地 讲解 了 与 OpenStack 相 关 的 Python 专业 知识 。 
2) 全 方位 涵盖 了 OpenStack 的 技术 知识 ， 包 括 DevStack、 开 发 基础 、API 调 用 、 源 码 及 结构 分 析 、 功 能 扩展 等 。 
3) 堪 称 零 基 础 入 门 。 本 书包 含 详尽 的 操作 步骤 ， 还 有 详细 图 示 操 作 指 引 及 错误 分 析 ， 带 领 读 者 步 入 OpenStack 开 发 的 殿堂 。 


4) 第 一 次 公开 OpenStack 开 发 企业 内 部 资料 一 一 工程 师 的 成 长 资料 及 资深 工程 师 的 日 常 工作 记录 ， 极 具 参 考 价值 。 


本 书 的 知识 体系 
全 书 共 分 八 个 部 分 : 
第 一 部 分 (第 1、2 章 ) : 首先 以 若干 名 企业 内 部 OpenStack 开 发 人 员 的 成 长 历程 为 例 ， 讲 解 OpenStack 开 发 人 员 应 具备 的 知识 体系 ; 然后 讲解 了 基本 开发 环境 的 搭建 。 
二 部 分 (第 3、4 章 ) : 不 同 于 市 面 上 的 Python 教材 ， 本 书 以 企业 内 部 教程 为 主线 ， 从 企业 应 用 角度 讲解 Python 基础 知识 、 优 化 原则 和 Openstack 中 Python 相关 的 模块 知识 。 
第 三 部 分 (第 5 ~ 7 章 ) : 讲述 了 消息 队列 、Devstack 开 发 环境 及 开发 的 相关 知识 ， 其 中 包含 一 些 基 本 概念 和 技巧 ， 是 Openstack 开 发 人 员 必 须 掌 握 的 入 门 知 识 。 


第 四 部 分 (第 8、9 章 ) : 本 部 分 首先 用 很 多 实例 讲解 了 Horizon 的 开发 框架 Django， 然 后 讲 了 Horizon 界 面 结构 ， 分 析 了 Horizon 的 源 代 码 ， 最 后 用 示例 完成 Horizon 的 开发 测试 过 程 。 


第 五 部 分 (第 10 章 ) : 本 部 分 首先 详 述 了 Nova 启 动 实例 的 流程 ， 接 着 分 析 了 Nova 的 源码 ， 最 后 用 示例 讲述 了 微 模 块 的 开发 过 程 。 
第 六 部 分 (第 11 章 ) : 本 部 分 首先 讲述 了 OpenStack 的 部 署 拓扑 和 实例 的 数据 流向 分 析 ， 接 着 对 Neutron 的 启动 流程 进行 了 跟踪 分 析 ， 最 后 扩展 了 Neutron 的 extensions 模 块 并 测试 其 功能 。 
第 七 部 分 (第 12 章 ) : 本 部 分 主要 讲述 了 OpenStack 测 试 的 相关 内 容 ， 包 含 开 发 人 员 个 人 的 单元 测试 和 团队 的 模块 集成 测试 技术 ， 为 代码 整合 打 好 基础 。 


第 八 部 分 (附录 A ~ D) : 首先 附录 A 讲述 了 国内 企业 对 OpenStack 社 区 的 贡献 ; 附录 B、C 分 别 对 OpenStack 的 Newton 和 Ocata 版 本 新 特性 进行 了 说 明 ; 附录 D 列 举 出 Git 代 码 管理 命令 供 读者 参考 ， 希 
望 可 以 为 读者 指明 学 习 的 方向 。 


本 书面 向 的 读者 
本 书 适用 于 想 从 事 OpenStack 开 发 及 深入 学 习 OpenStack 的 相关 人 员 。 本 书 也 可 以 作为 OpenStack 的 培训 教材 。 
如 何 阅读 本 书 


OpenStack 强 调 实践 ， 希 望 读 者 能 够 把 书 中 的 示例 代码 都 手动 输入 一 遍 ， 在 输入 运行 代码 的 过 程 中 可 能 会 出 现 输入 错误 、 语 法 错误 等 ， 读 者 可 以 自己 尝试 独立 解决 相关 问题 ， 逐 渐 增 加 自己 的 编程 经 
一 定 要 去 阅读 和 分 析 官 方 的 源码 ， 然 后 自己 尝试 去 修改 源码 ， 只 有 这 样 才能 锻炼 自己 的 开发 能 力 ， 逐 步 成 为 优秀 的 OpenStack 开 发 人 员 。 


致谢 


本 书 参考 了 部 分 官方 文档 以 及 北京 海 云 捷 迅 科技 有 限 公司 的 内 部 资料 ， 得 到 了 该 公司 周 征 晓 、 张 加 龙 、 叶 东 灿 、 郭 姗 、 伍 军 、 徐 夏 等 开发 人 员 的 大 力 支 持 ; 还 要 感谢 北京 海 云 捷 迅 科技 有 限 公司 的 张 征 
宇和 李 华 ， 在 他 们 的 大 力 支 持 下 本 书 才 得 以 完成 。 


感谢 云 技术 社区 创始 人 肖 力 老师 ， 是 肖 老 师 推 荐 了 华章 分 社 杨 福 川 副 主编 ， 还 要 感谢 出 版 社 其 他 工作 人 员 ， 有 了 他 们 的 共同 努力 ， 本 书 才 得 以 正式 出 版 。 


由 于 编撰 时 间 有 限 ， 加 上 Openstack 情 大 精深 ， 版 本 更 迭 较 快 ， 文 中 有 失效 或 分 析 不 对 的 地 方 还 请 读者 批评 指正 。 


第 1 章 ”Openstack 企 业 工 程 师 的 成 长 及 工作 介绍 


本 章 以 两 名 OpenStack 开 发 工程 师 的 成 长 历程 及 一 名 资深 工程 师 的 部 分 工作 内 容 为 例 ， 通 过 了 解 不 同 OpenStack 开 发 工程 师 的 工作 内 容 来 分 析 工 程 师 的 成 长 历程 。 


1.1 Horizon 界 面 工程 师 的 工作 内 容 


该 工程 师 大 概 12 月 份 入 职 ， 入 职 之 前 没有 Python 语 言 的 使 用 经 历 ， 现 在 主要 从 事 Horizon 界 面 的 开发 工作 ， 他 的 工作 内 容 可 以 参考 表 1-1。 


表 1-1 Horizon 界 面 工程 师 的 工作 内 容 


HEE 主要 工作 内 容 he 
12.2 ~ 12.23 第 一 个 月 主要 是 研读 代码 并 开始 学 
12,24. ^ 1.6 学 习 内 部 Python 课程 习 Python 语言 
1.7 — 1.8 搭建 RDO 环境 
调度 VPN 页 面 代码 第 二 个 月 已 经 学 完 Python 语言 ， 开 

T L hi OpenStack 始 安装 、 部 署 OpenStack 


2.1 一 2.3 研读 代码 并 总 结 
2.4 — 2.15 2016 年 中 国 新 年 假期 第 三 个 月 提高 了 研读 代码 的 速度 ， 
2.16 一 2.17 搭建 DevStack 环境 ， 做 了 一 些 测试 ， 人 研读 代码 已 经 学 会 使 用 Github， 开 始 查 看 bug 
2,22 = 299 调试 bug#1547998 ， 参 加 Ansible 培训 并 尝试 修改 

3.1 ~ 3.7 人 研读 代码 ， 更 新 patch， 总 结 整理 以 前 学 习 的 笔记 
3.9 — 3.10 研读 代码 ， 复 现 bugl325397 





第 四 个 月 可 以 看 到 该 工程 师 开 始 修 
改 Horizon 界面 。 学 习 的 渠道 包括 目 
3.11 — 3.15 MRE ZA TERI Sm HY form 中 增加 workflow 党、 内 部 培训 等 





(5) 


时 间 段 主要 工作 内 容 小 结 
3.16 一 3.23 调研 Horizon 样式 改版 第 四 个 月 可 以 看 到 该 工程 师 开 始 修 
学 习 阅 读 关 于 前 端 测 试 的 文档 ， 修 改 base HTML 模板 , | PX Horizon 界面 。 学 习 的 渠道 包括 目 


3.24 一 3.30 en 
继续 完善 Horizon 样式 改版 教程 ， 写 Horizon 开发 步骤 学 、 内 部 培训 等 





1.2 ”Neutron 网 络 工程 师 的 工作 内 容 


该 工程 师 大 概 2016 年 3 月 份 入 职 ， 入 职 之 前 有 相关 的 工作 经 验 ， 没 有 Python 语言 的 使 用 经 历 ， 现 在 主要 从 事 Neutron 网 络 相关 的 开发 工作 ， 他 的 工作 内 容 可 以 参考 表 1-2。 


表 1-2 ”Neutton 网 络 工程 师 的 工作 内 容 


时 间 段 主要 工作 内 容 小 结 
办 理 人 职 手续 ; 
dO TARTE AR DE THO AKT ; 


注册 OpenStack 社区 开发 相关 账号 ; 
RT. 注册 OpenStack 社区 开发 相关 账号 


在 Stackalytics 中 提交 个 人 信息 的 代码 ; 第 一 个 月 因为 有 

熟悉 Git 的 使 用 方法 ; 工作 经 验 ， 开 始 注册 

通过 DevStack 单 点 安装 OpenStack 账号 熟悉 工具 的 使 

安装 ubuntul4.04.4 64bit 虚拟 机 ; 用 ， 开 始 搭建 并 使 用 
3.21 一 3.25| 安装 各 组 件 ; OpenStack 


理解 核心 组 件 的 功能 

熟悉 DevStack 中 的 相关 脚本 (stack.sh/unstack.sh/rejoin-stack.sh/local.conf); 

熟悉 虚拟 机 的 使 用 及 排 错 方 法 

熟悉 Linux 网 络 虚拟 化 相关 技术 (network namespace, TAP/TUN, VETH); 

参考 K WRAY XH NOR. TET. WR. PPAR 3 个 节点 上 部 署 工 版 
本 的 OpenStack ; 

理解 OpenStack 中 的 4 种 网 络 类 型 (和 管理、 数据、 外 部 、API) 和 Neutron 
SEDAN 5 种 网 络 拓扑 ; 

理解 Neutron 二 层 网 络 服务 实现 原理 

3 Linux 网 络 虚拟 化 的 PPT (Network namespace 部 分 ); 

IH] OpenStack 环境 中 network 和 compute 节点 的 内 部 网 络 流程 图 ; 

熟悉 OVS 的 使 用 方法 ; 

熟悉 ovs-ofctl 的 使 用 方法 ， 理 解 compute T ji F br-int, br-tun 的 流 表 ， 并 
画 出 其 具体 流程 图 ; 

写 Linux 网 络 虚拟 化 的 PPT (OVS 部 分 ) 

理解 OpenFlow 协议 (v1.3 ); 

E Linux 网 络 虚 拟 化 的 PPT (iptables, OpenFlow 部 分 ); 

熟悉 netfilter/iptables (基本 用 法 、 目 定义 链 、Neutron 中 日 定义 链 的 初始 化 ); 

写 Linux 网 络 虚拟 化 的 PPT (iptables 部 分 ) 


AZ OpenStack Docs: OpenStack Networking Guide, Open vSwitch (ovs+vlan , 





3.48 ^^ 3.91 


4.] — 4.6 


第 二 个 月 主要 学 习 
Linux, OpenStack 网 
络 的 相关 内 容 


4.7 — 4.12 





4.13 — 4.16 





4.17 — 4.25 





ovs-gre ); 


(5E) 


Ay [8] E 主要 工作 内 容 小 结 

熟悉 Neutron 的 配置 文件 ( ml2 confini, openvswitch agentini), Linux Bridge 

4.17 ~ 4.25 | (linux_bridge+vlan linux_bridge+vxlan)、 使 用 分 布 式 虚拟 路 由 实现 高 可 用 (DVR); | 第 二 个 月 主要 学 习 
AA KS BS HI (IP rule) Linux, OpenStack 网 
熟悉 DVR 中 数据 包 的 流程 ; 络 的 相关 内 容 
通过 DevStack 部 署 多 节点 (controller 节点 和 network 节点 ) 

5.3 — 5.4 Python 基础 学 习 (数据 结构 、 类 和 对 象 ) 
理解 Neutron 代码 ; 

5.5 ~ 5.10 理解 Neutron 的 软件 实现 (WSGI 和 RPC); 
熟悉 Neuron 的 代码 实现 
结合 Neutron 的 代码 ， 熟 悉 OpenStack 的 通用 库 oslo.messaging、oslo.config; 
熟悉 Neutron 中 M12 plugin 与 数据 库 的 交互 流程 ， 并 理解 Type Manager, 

Mechannism Manager, Type Driver, Mechanism Driver 的 实现 机 制 ; 
理解 Neutron 中 的 ovs neutron agent.py 代码 (OVS 网 桥 的 初始 化 ( br-int, 
br-tun, br-ex) 以 及 各 个 网 桥 的 流 表 的 初始 化 ); 

学 习 Neutron 相关 的 Web 框架 (Paste+Paste Deploy+Routes+WebOb ) 
学 习 MySQL 数据 库 的 基本 操作 (MySQL 数据 库 入 门 ); 
学 习 Python 数据 库 的 编程 (MySQL DB 模块 ); 
学 习 在 OpenStack 社区 中 修补 bug 的 流程 ; 
OpenStack 社区 Neutron bug1580927 的 验证 与 处 理 ， 涉 及 RFC3021 在 IPv4 





4.26 一 4.28 


5.11 — 5.14 


第 三 个 月 开始 学 
2] Python id A, W 


点 对 点 连接 中 作 WAY 28 : ‘cet ps 
5.16 u 5.24 ROS RESET BER 31 位 前 SX 5 | u i OpenStack 源 代码 ， 
OpenStack 社区 Neutron bug1580927 的 修改 与 提交 ; 提交 发 现 的 bug 


熟悉 Neutron 中 13-agent 相关 代码 实现 ; 

查找 并 整理 SDN 应 用 相关 的 资料 ( SDN 技术、 标准、 产业 发 展现 状 ，SDN 
技术 在 电力 光 通 信和 网 络 中 的 应 用 人 研究 ); 

熟悉 Neutron 中 相关 代码 的 实现 

Neutron DVR 中 公 网 IP 地 址 浪费 问题 的 调研 (fg H ); 

服务 器 上 搭建 测试 环境 ， 通 过 Virt-Manager 安装 虚拟 机 (创建 controller, 
network, computel 市 点 ); 

定位 现场 问题 : 在 现场 某 种 应 用 场景 下 ， 导 致 LAN 间 无 法 正常 通信 的 原因 

5.25 ~ 5.31 | 是 在 Neutron 中 为 了 防止 IP 地址 欺骗 的 过 滤 规 则 (接口 IP&MAC HE) Xf 

相关 报 文 ; 





理解 Neutron 中 的 port security、security group; 
分 析 Neutron 中 的 ovs*vlan 数据 流程 (Neutron 网 络 实现 : ovs+vlan ); 
理解 Neutron 中 的 Linux 路 由 (Neutron 网 络 实 现 ， Linux 路 由 基础 ) 





1.3 ”Nova 资 深 工程 师 的 工作 内 容 


该 工程 师 拥 有 4 年 多 的 Nova 开 发 经 验 ， 现 在 主要 从 事 Nova 相 关 的 开发 工作 ， 他 的 工作 内 容 可 以 参考 表 1-3，。 


表 1-3 2016 年 5 月 份 工作 日 报 


ET [8] E 


GL. Gf 


6.8 — 6.14 


6,159. 05.13 


D. 


主要 工作 内 容 

1. 继续 开发 某 公 司 三 期 项 目的 功能 ， 基 本 完成 snapshot 的 相关 架构 和 设计 文档 ， 准 备 进 行 代 码 的 编写 。 

2. 调查 某 公 司 环境 指定 datastore 无 法 创建 VM 的 问题 。 主 要 原因 是 该 公司 上 自己 在 VMware 设置 了 
相关 的 策略 ， 导 致 存储 无 法 创建 。 

3. 调查 某 公 司 环境 无 法 创建 image 的 问题 ， 原 因 在 于 某 公 司 用 于 创建 image 的 VM 太 大 ，vsphere 
超时 ， 导 致 创建 失败 。 

4. 搭建 Mitaka 环境 ， 为 AWSTACK 2.0 底层 架构 梳理 比较 合适 的 配置 项 。 

5. 调查 某 公 司 环境 出 现 的 问题 ， 确 定 该 公司 的 环境 存在 部 分 datastore 无 法 创建 虚拟 机 。 

6. 完成 Mitaka 版 本 环境 的 搭建 ， 完 成 相关 配置 文件 的 整理 。 

7. 处 理 某 公司 无 法 进行 虚拟 机 迁移 的 问题 ， 问 题 的 原因 在 于 该 公司 进行 迁移 时 ， 缺 少 几 个 必需 的 参 
数 ， 导 致 迁移 失败 。 

8. 处 理 某 公司 无 法 挂 载 volume 的 问题 ， 问 题 的 原因 在 于 该 公司 进行 volume 的 挂 载 时 ， 本 号 只 有 
vl 的 endpoint， 但 是 ,在 调用 的 时 候 使 用 的 是 v2 的 endpoint， 导 致 无 法 访问 ， 从 而 挂 载 失败 

1. 解决 某 公 司 VM resize 的 问题 ， 结 果 发 现 并 没有 出 现 所 说 的 情况 。 

2. 为 同事 讲解 在 Nova 当中 开发 的 新 功能 一 一 显示 ebs 虚拟 机 image。 

3. 为 同事 讲解 Nova 当中 开发 的 新 功能 一 一 设置 VM 的 qos。 

. 开始 分 析 project admin 的 角色 定位 以 及 权限 管理 。 

.完成 project admin 的 角色 定位 以 及 权限 管理 的 基础 demo 版 本 。 

. 为 同事 讲解 Keystone 中 关于 权限 管理 的 部 分 。 

.完成 project admin 的 角色 定位 以 及 权限 管理 ， 并 且 重 写 policy 策略 ， 屏蔽 对 admin 的 disable 操作 。 
. 为 同事 讲解 Nova license 和 其 他 相关 功能 的 概念 和 基础 逻辑 。 

. 为 同事 讲解 Keystone 中 关于 权限 管理 的 部 分 

重新 部 署 Mitaka 环境 ,为 AWSTACK 2.0 配置 符合 业务 需求 的 权限 策略 。 

为 同事 讲解 Nova 的 代码 ， 包 括 drs、 定 时 任务 等 。 

为 同事 解决 Keystone 方面 的 问题 ， 发 现 其 调用 Keystone 的 API AIR, 只 调用 了 一 部 分 API. 
为 同事 讲解 Nova 的 代码 ， 包 括 live-resize 等 新 功能 。 

重新 规划 权限 系统 ， 开 始 实现 AWSTACK 2.0 所 需要 的 monitor 角色 权限 。 

.完成 Keystone 的 monitor 角色 权限 配置 ， 开 始 设 计 Nova 的 monitor 权限 。 

7. 实现 AWSTACK 2.0 所 需要 的 monitor 角色 权限 但是， 发 现 monitor 权限 在 目前 的 OpenStack 
当中 ， 由 于 部 分 项 目 固化 在 代码 当中 ， 而 不 是 完全 交 给 policy 策略 文件 管理 ， 从 而 导致 某 些 项 目下 
monitor 角色 的 权限 管理 失效 。 

8. 查找 AWSTACK 2.0 当中 ，admin 获取 的 token 没有 catalog 存在 的 问题 。 结 果 发 现 是 kolla 在 初始 
化 Keystone 之 时 ， 并 没有 为 使 用 keystone-manage 创建 的 admin 用 户 添 加 相关 的 project， 导 致 无 法 获 
取 到 catalog 

1. 完成 所有 权限 策略 文件 的 编写 ， 并 提交 公司 代码 仓库 。 

2. 修复 社区 bug (https://launchpad.net/bugs/1534052 )， 并 提交 相关 的 lite-spec ( https://review.openstack. 
org/4/c/324195/) 。 

3. 处 理 某 公司 无 法 进行 VM 迁移 的 问题 ， 原 因 是 他 们 的 开发 人 员 调 用 接口 错误 。 

4. 某 公 司 项 目 文 持 ， 添 加 接口 文 持 ， 使 之 能 够 查询 到 VM 所 在 ESXi 和 datastore. 

5. 创 客 问题 排查 ， 最 后 发 现 是 Neutron 存在 部 分 的 问题 。 

6. 公司 项 目 文 持 ， 和 同事 讨论 存储 迁移 的 开发 方案 。 

7. 调 研 某 stack 的 功能 ， 整 理 我 们 所 需要 的 功能 点 


An Row Neje om 上 


BY B ER 主要 工作 内 容 
1. DAME stack 的 功能 ， 整 理 我 们 所 需要 的 功能 点 ， 整 理 完 成 。 
2. LFF AWSTACK 2.0 开发 ， 解决 北京 同事 无 法 使 用 publicurl 管理 Keystone 的 问题 。 
6.23 一 625| 3. 文 持 AWSTACK 开发 ， 开 始 处 理 Keystone 返回 的 URL 错误 的 问题 。 
4. 汇报 小 组 工作 ， 讨 论 镜 像 制作 的 问题 ， 讨 论 多 region ip IJ IR] A 
5. 处 理 Keystone 的 publicurl 问题 
1. 处 理 Keystone 的 publicurl 的 问题 ， 确 认 问 题 的 原因 。 如 果 需 要 像 以 前 一 样 ， 直 接 使 用 database 
中 的 URL， 则 需要 重新 提交 。 
2. 调研 VMware 的 冷 迁 移 功 能 。 
3. 协助 某 同事 搭建 CI 环境 
1. Jit VMware 的 冷 迁 移 功 能 ， 完 成 基本 功能 的 测试 。 确 定 冷 迁移 可 以 实现 。 
2. 调研 VMware AY HEI HL SER. AK VM 一 样 ，VMware 克隆 出 来 的 虚拟 机 的 Mac 地 址 是 完全 一 样 
6.28 的 ， 这 会 导致 死 隆 出 来 的 虚拟 机 无 法 使 用 ; 如 果 原 本 虚拟 机 存在 多 个 磁盘 ， 或 者 挂 载 了 volume， 则 殉 
隆 的 虚拟 机 也 会 创建 一 个 新 的 volume， 但 是 ， 这 个 volume 不 会 由 OpenStack 管理 ， 这 是 一 个 比较 麻 
烦 的 问题 
1. 开始 测试 VMware 的 虚拟 机 殉 隆 功能 。 目 前 打算 集成 到 OpenStack 当中 进行 修改 。 
6.29 ~ 6.30| 2. 开始 构思 VMware 克隆 功能 的 开发 以 及 相关 要 点 ， 并 开始 编写 相关 文档 。 目 前 ， 克 隆 需 要 按照 
OpenStack 的 create 逻辑 进行 ， 相 对 而 言 ， 比 较 复 困 


6.27 


可 见 ， 一 个 资深 Nova 工 程 师 的 工作 内 容 和 工作 效率 ， 除 了 开发 工作 外 ， 他 还 要 参与 新 员工 的 培训 等 工作 ， 这 应 该 是 我 们 学 习 的 目标 。 


14 ”本章 小 结 


本 章 从 三 个 维度 对 OpenStack 开 发 工作 进行 了 阐述: 一 是 刚 毕业 的 大 学 生 是 怎么 学 习 并 从 事 OpenStack Horizon 界 面 开发 工作 的 ;二 是 有 工作 经 验 的 工程 师 是 怎么 进入 OpenStack Neutron 开 发 工作 
AY; 三 是 资深 的 Openstack 开 发 工程 师 每 天 所 做 的 工作 。 和 希望 读者 根据 实际 情况 找到 适合 自己 的 学 习 方 法 ， 尽 早 加 入 到 Openstack 这 个 大 家 庭 中 来 。 


第 2 草 ” 开 友 环 境 的 搭建 


从 第 1 章 可 以 看 出 ， 开 发 者 首先 需要 学 会 一 些 开源 工具 的 使 用 方法 ， 包 括 Git 代 码 管 理工 具 、Python 的 开发 工具 等 ， 还 要 学 会 自己 搭建 Python 开 发 环境 及 OpenStack 开 发 环境 。 开 发 环境 分 为 两 种 : 一 
种 是 在 本 地 编写 代码 然后 上 传 到 服务 器 调试 运行 (服务 器 可 以 是 OpenStack 的 虚拟 机 或 物理 机 ， 本 地 可 以 是 Windows 或 Linux 操 作 系 统 ， 普 通 配 置 的 笔记 本 电脑 即 可 ， 但 要 注意 操作 系统 必须 是 64 位 ) ; A 
一 种 是 直接 在 OpenStack 的 虚拟 机 或 物理 机 上 编写 代码 ， 这 要 求 对 Linux 比 较 熟 悉 。 本 章 将 对 两 种 环境 分 别 进行 说 明 ， 读 者 可 以 根据 自身 的 情况 进行 选择 。 


2.4 Windows 开 友 环 境 的 搭建 


大 家 对 Windows 比 较 熟 悉 ， 上 手 比较 快 ， 下 面 先 来 讲解 一 下 Windows 环 境 的 搭建 。 注 意 ，Windows 操 作 系 统 要 求 是 64 位 的 ， 安 装 的 软件 包括 Git、jJava 运 行 环境 、Python 集 成 开发 环境 、PyCharm,， 
如 图 2-1 所 示 。 





£5» Git-2.10.0-64-bit 





Em m = 





|i] jd k-Bu101-windows-x64 
| el jre-8u101-windows-x64 
[id pycharm-community-2016.2.3 
python-2.7.5 
iB! python-2.7.1 


图 2-1 需要 安装 的 软件 及 软件 版 本 











E 








24.1 Git 的 安装 


Git 安 装 包 的 下 载 链接 为 https://www.git-scm.com/download/， 可 以 根据 不 同 的 平台 下 载 需要 的 版 本 ， 如 图 2-2 所 示 。 


Downloads 


Latest source Release 
p - 1 Oo . Oo 


(2016-09-02) 


ex Mac OS X A Windows 
à Linux 31s Solaris Downloads for Windows 


Older releases are available and the Git source 


repository is on GitHub. 





GUI Clients Logos 

Git comes with built-in GUI tools (git-gui, Various Git logos 1n PNG (bitmap) and EPS 
gitk), but there are several third-party tools (vector) formats are available for use in 
for users looking for a platform-specific online and print projects. 

experience. 


View Logos — 
View GUI Clients — 


Git via Git 
If vou already have Git installed, vou can get the latest development version via Git itself: 


git clone https://github.com/ git/ git 
You can also always browse the current contents of the git repository using the web interface. 


图 2-2 ”Git 的 下 载 及 版 本 选择 


单 击 “ 下 载 ”按钮 后 开始 下 载 ， 下 载 的 版 本 是 2.10.0，64 位 版 本 ， 如 图 2-3 所 示 。 


新 建 下 载 任务 
网 址 : | https:;//github-cloud.s3.amazonaws.com/releases/2 


名 称 : Git-2.10.0-64-bitexe 软件 31.52 MB | 


FSS: [DAbook\ 102468» || ix. 





图 2-3 下 载 的 版 本 及 位 数 


下 载 完 成 后 双击 Cit-2.10.0-64-bit 开 始 安装 Git 软 件 ， 同 意 协议 如 图 2-4 所 示 。 


选择 安装 路 径 ， 如 图 2-5 所 示 。 


选择 Git 的 组 件 ， 包 括 Bash 和 GUI， 这 里 使 用 默认 值 ， 如 图 2-6 所 示 。 


选择 “开始 ”菜单 中 文件 夹 的 名 称 ， 这 里 使 用 默认 值 即 可 ， 如 图 2-7 所 示 。 


配置 为 “可 以 在 Windows 命 令 行 使 用 Git 命 令 ”， 如 图 2-8 所 示 。 


配置 命令 结束 的 样式 ， 如 图 2-9 所 示 。 


©> Git 2.10.0 Setup 


Information 


Please read the following important information before continuing. 


When you are ready to continue with Setup, click Mext. 


GNU General Public License 


Version Z, June 1991 


Copyright (C) 1989, 1991 Free Software Foundation, Inc. 
5B Temple Place - Suite 330, Boston, MA 02111-1307, USA 


EPFL YT 1s permitted to copy and distribute verbatim copies 
lot this license document, but changing 让 3s not allowed, 


Preamble 


The licenses for most software are designed to take away your 


freedom to share and change it. By contrast, the GNU General Public 
license ig intended to ouarantee vouir freedom to share and channe 


Hoit-For-windows github dos 


netos 





图 2-4 同意 协议 


Select Destination Location 
Where should Git be installed? 


A Setup will install Git into the following folder. 


To continue, dick Next. If you would like to select a different folder, dick Browse. 


i: Program Files Wait 


Atleast 192.9 MB of free disk space is required. 


hiEEps: olt-For-windows github jos 





E]2-5 ”选择 安装 路 径 


Select Components 
Which components should be installed? 


©» Git 210.0 Setup - — IE x] 


&, 
X 


Select the components you want to install; dear the components you do not want to 
install, Click Mext when you are ready to continue. 


Windows Explorer integration 
z Git Bash Here 
:区 Git GUI Here 
Assodate .git* configuration files with the default text editor 
Associate ,sh files to be run with Bash 
Use a TrueType font in all console windows 


Current selection requires at least 192.7 MB of disk space. 


https: | fait-For-windows, github jo} 


< Back 





图 2-6 选择 需要 的 组 件 


二 Git 210.0 Setup 
Select Start Menu Folder 
Where should Setup place the program's shortcuts? 


i Setup will create the program's shortcuts in the following Start Menu folder. 


To continue, dick Next. If you would like to select a different folder, dick Browse. 


"| Don't create a Start Menu folder 
https: JJ git-Far-windows, github or 





图 2-7 文件 夹 名 称 


©» Git 2.10.0 Setup 


Adjusting your PATH environment 
How would you like to use Git from the command line? 


|. Use Git from Git Bash only 


This is the safest choice as your PATH will not be modified at all. You will only be 
able to use the Git command line tools from Git Bash. 


This option is considered safe as it only adds some minimal Git wrappers to your 
PATH to avoid duttering your environment with optional Unix tools, You will be 
able to use Git from both Git Bash and the Windows Command Prompt. 


| | Use Git and optional Unix tools from the Windows Command Prompt 


Both Git and the optional Unix tools will be added to your PATH. 
Warning: This will override Windows tools like "find" and "sort". Only 


hiEEps: JJ olt-For-windows, github jos 


图 2-8 Windows 4-47 4% JA Gita 4- 





oY Git 2.10.0 Setup 


Configuring the line ending conversions 
How should Git treat line endings in text files? 


Git will convert LF to CRLF when checking out text files. When committing 

text files, CRLF will be converted to LF. For cross-platform projects, 

this is the recommended setting on Windows ("core.autocrlf" is set to "true 小 
0 1 Checkout as-is, commit Unix-style line endings 


Git will not perform any conversion when checking out text files. When 
committing text files, CRLF will be converted to LF. For cross-platform projects, 
this is the recommended setting on Unix ("'core,autocrlf" is set to "input ). 

| Checkout as-is, commit as-is 


Git will not perform any conversions when checking out or committing 
text files. Choosing this option is not recommended for cross-platform 
projects ('core,autocrlf" is set to "false 小 


https?) git-For-windows, github io) 





图 2-9 ”配置 命令 结束 的 样式 


配置 Bash 命 令 终端 样式 ， 如 图 2-10 所 示 。 


€» Git 2.10.0 Setup 


Configuring the terminal emulator to use with Git Bash “ 
Which terminal emulator do you want to use with your Git Bash? » 


Git Bash will use MinTTY as terminal emulator, which sports a resizable window, 
non-rectangular selections and a Unicode font. Windows console programs (such 
as interactive Python) must be launched via winpty to work in MinTTY. 


|, Use Windows’ default console window 


Git will use the default console window of Windows ('cmd.exe"^), which works well 
with Win32 console programs such as interactive Python or node.js, but has a 
very limited default scroll-back, needs to be configured to use a Unicode font in 
order to display non-ASCII characters correctly, and prior to Windows 10 its 
window was not freely resizable and it only allowed rectangular text selections. 











L^ | INL da" IEP io Jo) — 





图 2-10 ”配置 Bash 命 令 终端 样式 


配置 扩展 选项 ， 使 能 系统 缓存 ， 如 图 2-11 所 示 。 


£5 Git 2.10.0 setup 


Configuring extra options 
Which features would you like to enable? 


File system data will be read in bulk and cached in memory for certain 
operations ("core.fscache" is set to rue). This provides a significant 
performance boost. 


Enable Git Credential Manager 


The Git Credential Manager for Windows provides secure Git credential storage 
for Windows, most notably multi-factor authentication support for Visual Studio 
Team Services and GitHub. (requires .NET framework v4.5.1 or or later) 


| < Back <Back || instal | | Cancel 


图 2-11 允许 文件 系统 缓存 





限于 篇 幅 ， 这 里 省 略 安 装 进度 等 细节 ， 完 成 后 会 自动 跳 转 到 Release Notes 界 面 ， 如 图 2-12 所 示 。 
安装 完成 后 不 会 生成 桌面 图 标 ， 但 在 “开始 ”菜单 会 有 Git 的 文件 夹 ， 包 括 Git Bash, Git CMD, Git GU13 个 命令 ， 如 图 2-13 所 示 。 
Git Bash 是 Linux 的 命令 行 ， 可 以 使 用 简单 的 Linux 命 令 ， 如 图 2-14 所 示 。 


Git CMD 是 Git 的 命令 行 ， 可 以 使 用 Git 命 令 ， 如 图 2-15 所 示 。 


Git for Windows v2.10.0 Release Notes 


Latest update: September 3rd 2016 


Introduction 


These release notes describe issues specific to the Git for Windows release. The release notes covering the history of the core git commands can be 


Ee roiect 
Ji PIOS 


1/ for further details about Git including ports to other operating systems. Git for Windows is hosted at | 


Known Issues 


Special permissions (and Windows Vista or later) are required when cloning repositories with symbolic links, therefore support for symbolic links is 
disabled by default. Use git clone -c core. symlinks-true <URL> to enable it, see details 
If configured to use Plink, you will have to connect with putty first and accept the host key. 
Some console programs, most notably non-MSYS2 Python, PHP, Node and OpenSSL, interact correctly with MinTTY only when called through 
winpty (e.g. the Python console needs to be started as winpty python instead of just python). 

uses $HOME/ netrc instead of $HOME/. netrc. 
If you specify command-line options starting with a slash, POSIX-to-Windows path conversion will kick in converting e.g. "/usr/bin/bash. exe" to 
"C:\Program Files\Git\usr\bin\bash. exe". When that is not desired — e.g. "—upload-pack-/opt/git/bin/git-upload-pack" or "-L/regex/" — you 
need to set the environment variable MSYS NO PATHCONV temporarily, like so: 


MSYS NO PATHCONV-1 git blame -L/pathconv/ msys2 path conv.cc 





图 2-12 Release Notes tw 


ji Git 
Git Bash 


Git CMD 
Git GUI 


图 2-13 ”Git 的 安装 组 件 


MINGWOd:/c/Users/zw2002 








cfUsers/zw2002 





图 2-14 Bash## X 


Git CMD 


C: \\Users \zw2002>q1t 

usage: git [--version] [--hel : ath>] [-c name-value] 

| [--exec- ain help E erni path] [--man-path] [--info-path] 
[-p | --paginate | --no-pager] [--no-replace-objects] [--bare] 
[--git-dir-«path-] [--work-tree-«path-] [--namespace=<name> | 
«command: [<args>] 


These are common Git commands used in various situations: 
| 
start a working area (see also: git help tutorial) 
| clone Clone a repository into a new directory 
init Create an empty Git repository or reinitialize an existing one 


work on the current change (see also: git help everyday) 
add Add file contents to the index 
mv Move or rename a file, a directory, or a symlink 
reset Reset current HEAD to the specified state 
rm Remove files from the working tree and from the index 











examine the history and state (see also: git help revisions) 


bisect use binary search to find the commit that introduced a bug 
rep Print Lines matching a pattern 
og Show commt logs 
show Show various types of objects 
J status Show the working tree status 








E245 Git 4-3] iX 


多 


也 可 以 在 Bash 中 输入 Git 命 令 来 进行 操作 。 


Git GUI 是 Git 的 图 形 操作 界面 ， 可 以 通过 图 形 来 完成 Cit 命 令 ， 如 图 2-16 所 示 。 


Clone Existing Repositon 





图 2-16 图形 界 面 操作 
Qi 


Git 的 使 用 将 在 后 面 的 章节 讲解 ， 主 要 内 容 是 使 用 Git 命 令 操 作 ， 图 形 界面 的 操作 可 以 参考 其 他 相关 资料 。 


2.1.2 ”JDK 的 安装 与 配置 


JDK 安 装 包 的 下 载 链接 为 http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html。 


在 下 载 页 面 下 载 JDK (Java Development Kit) 集成 开发 环境 ， 如 图 2-17 所 示 。 


Java Platform, Standard Edition 





Java SE 8u101 / 8u102 

Java SE 8u101 includes important security fixes. Oracle strongly recommends that all Java SE 
8 users upgrade to this release. Java SE SuT102 is a patch-set update, including all of Su 107 
plus additional features (described in the release notes). 

Learn more + 


= Installation Instructions JDK 


DOWNLOAD + 
» Release Notes | 


= Oracle License 


" Java SE Products Server JRE 
" Third Party Licenses DOWNLOAD * 





= Certified System Configurations 


"= Readme Files 
JRE 


" JDK ReadMe 


" JRE ReadMe 





Oi 


图 2-17 JDKFR 


JDK 是 面向 开发 人 员 使 用 的 SDK (Software Development Kit) ,提供 了 Java 的 开发 环境 和 运行 环境 。SDK 一 般 指 软件 开发 包 ， 可 以 包括 函数 库 、 编 译 程序 等 。 


建议 把 JRE (Java Runtime Environment) 也 一 起 下 载 ， 后 面 的 API 测 试 工 具 会 用 到 。JRE 是 指 Java 的 运行 环境 ， 是 面向 Java 程 序 的 使 用 者 ， 而 不 是 开发 者 。 


JDK 先 要 同意 协议 才能 下 载 ， 选 择 相应 的 版 本 ， 如 图 2-18 所 示 。 


Java SE Development Kit 8u101 


You must accept the Oracle Binary Code License Agreement for Java SE to download this 


Windows x54 


software. 
Accept License Agreement © Decline License Agreement 


Product / File Description File Size Download 
Linux ARM 32 Hard Float AHI TPP MB  jdk-SuT0 1-inux-arm32-vfp-hflt tar qz 
Linux ARM 64 Hard Float ABI FA]72MB  jdk-8u101-linux-arm64-vip-hiit tar.gz 
Linux x85 150.28 MB . jdk-Bu101-linun-i586.rpm 
Linux x85 1/4865 MB X jdk-Su101-inux-i586 tar.gz 
Linux x54 158.27 MB jdk-8u707-linux-x64 rom 
Linux x64 17295 MB  Jjdk-Bu101-linux-xb4 tar. qz 
Mac OS X J2/[.35 MB — jdk-Bu101-macosx-x54.dmq 
solaris SPARC 64-bit 139.66 MB  jdk-Su101-salaris-sparcv8 tar? 
Solaris SPARC 64-bit 96.96 MB jdk-6u101-solans-sparcy9 tar.gz 
solaris x64 140.33 MB jdk-6u101-solaris-x64 tar?’ 
solaris x64 96.78 MB jdk-bu701-solans-x64 tar.gz 
Windows x66 188.32 MB jdk-6u701-windows-i566.exe 


193.58 MB  jdK-Bu'0'1-windows-x64.exe 


图 2-18 ” JDK 对 应 的 系统 及 版 本 


同意 协议 后 ， 选 择 jdk-8u101-windows-x64.exe， 然 后 单 击 “ 下 载 ”按钮 ， 如 图 2-19 所 示 。 


pitt : 120.524.7221 /o0c 
RF: jdk-8ul01-windows-x64.exe Belt 193.68 MB 
下 载 到 : |DAbook 341022 GB v spar 





图 2-19 下载 的 版 本 


双击 安装 包 之 后 开始 安装 JDK， 如 图 2-20 所 示 。 


Java SE Development Kit 8 Update 101 (64-bit) - 安装 程序 


y 
= Java 


RAJ FA Java SE TF LER 8 Update 切 1 的 安装 回 亏 


Alo) S HE Eh. Java SE TEE [ E 8 Update 101 FISZA& THERE e 


Java Mission Control 73 T3 fr LAE AEE A) _DK 有 的 一 部 分 近世 。 





图 2-20 ”开始 安装 


定制 安装 ， 使 用 默认 值 就 可 以 ， 如 图 2-21 所 示 。 


期 | Java SE Development Kit 8 Update 101 (64-bit) - 定制 安装 


wm 
= Java’ 
M T aS Ic eee e eese TR DER o TROL TEES ae APS BE FRED STARR TE Feo 
3L FA ts FERES AEA DO Ae 
功能 说 明 
Java SE Development Kit 8 
Update 101 (64-bit), RHS 
JavaFX SDK, 一 个 专用 JRE ELE 
Java Mission Control T BE 


件 。 e 


drae E|: 
C:\Program FilesJavaiidki.8.0_i0i\ 





图 2-21 组件 安 装 


Qs. 
这 里 有 JRE 的 组 件 ， 默 认 丰 接 安装 ， 以 前 的 低 版 本 可 能 需要 单独 安装 。 


选择 安装 路 径 ， 如 图 2-22 所 示 。 


Java SSS - Ete 


m 


= java 





EJ LE 


目标 文件 卖 


BiG "pe" 以 将 Java SERIE MW o 


oF ae Fl: 
C:\Program Files\Java\jrel.6.0_ 101 








图 2-22 选择 安装 路 径 
Qi 
注意 安装 路 径 ， 目 前 的 版 本 不 需要 再 配置 环境 变量 。 


安装 过 程 比较 简单 ， 这 里 不 再 乾 述 。 下 面 验证 一 下 是 否 正确 安装 了 开发 环境 ， 进 入 Windows 的 命令 窗口 ， 输 入 “java” 命令 ， 若 有 如 图 2-23 所 示 的 输出 ， 则 表明 正确 安装 了 java 集成 开发 环境 。 
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图 2-23 ”运行 测试 


JDK8 不 需要 配置 环境 变量 ， 即 不 添加 环境 变量 ， 上 面 的 Java 测 试 也 可 以 直接 成 功 。 


之 所 以 要 安装 JDK， 是 因为 下 面 要 安装 的 Python 开发 工具 PyCharm 是 需要 java 支持 的 。 


Python 安装 包 的 下 载 链接 为 https://www.pytl 


注意 选择 版 本 ，Python2 和 Python3 版 本 的 差异 比较 大 ， 所 以 需要 根据 实际 情况 选择 相应 的 版 本 下 载 ， 如 图 2-24 所 示 。 











Wondering which version to use? | 


between Python 2 and 3. 


Looking for Python with a different OS? Python for Windows, 


Linux/UNIX, Mac O5 X, Other 


Wantto help test development versions of Python? Pre-releases 


图 2-24 支持 的 版 本 及 操作 系统 





oor 


一 般 来 说 ， 建 议 选择 与 安装 OpenStack 环 境 版 本 相 一 致 的 Python 版 本 。 在 OpenStack 环 境 中 输入 “python” 按 回 车 键 ， 就 会 看 到 Python 版 本 号 等 信息 ， 如 图 2-25 所 示 。 


[rootànode-1 ~]# python 

Python 2.7.5 (default, Nov 20 2015, 02:00:19) 

[GCC 4.8.5 20150623 (Red Hat 4.8.5-4)] on linux2 

Type "help", "copyright", "credits" or "license" for more information. 


>>> 


图 2-25 查看 环境 的 Python 版 本 


单 击 图 2-24 中 的 下 载 链接 ， 进 入 下 载 页 面 ， 可 以 选择 自身 环境 相对 应 的 Python 版 本 ， 这 里 下 载 的 是 2.7.5， 如 图 2-26 所 示 。 
SEE EIS X 
WIE: | https//www.python.org/Rp/python/27.5/python-2 


Lm oom 


SER: | python-2.7.5.msi gu 15.48 MB 


下 载 到 | : DAboolà 241021 GB v 浏览 


uj 
Ti: 


Berit 





图 2-26 ”Python 版 本 


本 书 采 用 的 版 本 是 2.7.5， 安 装 过 程 如 图 2-27 所 示 。 





期 | Python 2.7.5 Setup 


Select whether to install Python 2.7.5 
for all users of this computer. 








图 2-27 开始 安装 Python 


选择 安装 路 径 ， 如 图 2-28 所 示 。 





$ Python 2.7.5 Setup 


Select Destination Directory 


Please select a directory for the Python 2.7.5 files. 


Ei Python27 " 


[CAPyth 0n27 





图 2-28 选择 安装 路 径 
Oi 
需要 记 住 安 装 路 径 ， 配 置 环境 变量 时 要 用 到 。 


安装 Python 组 件 ， 保 持 默认 值 即 可 ， 如 图 2-29 所 示 。 


期 | Python 2.7.5 Setup tim 


Customize Python 2.7.5 


Select the way vou want features to be installed. 
Click on the icons in the tree below to change the 
way Features will be installed. 


-| Register Extensions 
—3 +) Tcl/Tk 
I~) Documentation 
-| Utility Scripts 
| Test suite 


Python Interpreter and Libraries 


puth n This feature requires 22MB on your hard drive. It 
| has 5 of 5 subfeatures selected. The subfeatures 
require 29MB on your hard drive. 


windows 
| Disk Usage | — | Advanced | | < Back | 





图 2-29 ”安装 Python 组 件 


安装 过 程 比较 简单 ， 安 装 完 之 后 不 能 直接 运行 Python 命令 ， 需 要 设备 环境 变量 ， 如 图 2-30 所 示 。 


C: XUsersMzw2002-. 





图 2-30 “Python 命令 执行 失败 


打开 “系统 属性 ”对 话 框 ， 单 击 “ 环 境 变量 ”按钮 ， 如 图 2-31 所 示 。 


在 打开 的 “系统 变量 ”对 话 框 中 找到 Path 变 量 ， 双 击 编辑 该 变量 对 应 的 值 ， 如 图 2-32 所 示 。 








| 计算 机 名 let | 高 级 | 系统 保护 | 
要 进行 大 凶 数 生疏 ， 您 必须 作为 管理 员 登 录 。 
性 能 
视觉 效果 ， 处 理 器 计划 ， 内 存 使 用 ， 以 及 虚拟 内 存 


REEL.. | 
Fi PB 
与 您 登录 有 美的 点 面 设置 
‘ee @)... | 
启动 和 故障 恢复 
Fin Bel. mimm 
Em. | 












LIEGT 


zw2002 HAPEE Qn 


IB 


WISERPRÜFILEE*Appliata*Local^iTemp 
WISERPRÜFILEX'*Applata*Local^Temp 





ARISE)... | | HRD) 
AE E) 


m iB 3 
05 Windows HT E 





C: ‘Froeramllata‘Dracle\ Tava\ ara ., 
FATHEXT .LDOM;.ERE;. BAT; .CMD;. VBS;. VBE;.... 
PROCESSOR ak AMTAA = 





Wie || WR 


图 2-32 Pathzt € 


双击 编辑 该 变量 对 应 的 值 ， 在 行 末 输入 “; ”， 然 后 把 Python 的 安装 路 径 加 进去 ， 如 图 2-33 所 示 。 


编辑 系统 变 县 


Fath 


marr 
E 


ÉAProgram Files\Git cmd; SOS 





图 2-33 ”添加 Python27 路 径 


重新 开 一 个 CMD 的 终端 ， 输 入 “python” ， 兰 出 现 如 图 2-34 所 示 的 内 容 ， 则 说 明 Python 安 装 成 功 了 。 


E Git CMD - python 


C:\Users\zw20027>python 
ython 2.7.5 (default, May 


V 
E | 

sl 
— 


v.1500 32 bit (Intel)] on win 


more information. 


Type "help", "copyright", 





图 2-34 ”Python 验证 成 功 


2.1.4 ”PyCharm 的 安装 与 配置 
PyCharm 是 一 种 Python IDE， 带 有 一 整套 可 以 帮助 用 户 使 用 Python 语言 提高 开发 效率 的 工具 ， 如 调试 、 语 法 高 亮 、Project 管 理 、 代 码 跳 转 、 智 能 提示 、 自 动 完成 、 单 元 测试 、 版 本 控制 。 此 外 ， 该 
IDE 提 供 了 一 些 高 级 功能 ， 用 于 支持 Django 框 架 下 的 专业 Web 开 发 。 


PyCharm 安 装 包 的 下 载 链 接 为 http://www.jetbrains.com/pycharm/。PyCharm 有 收费 版 本 和 免费 版 本 ， 这 里 我 们 选择 “Community” 就 可 以 满足 OpenStack 的 开发 需求 ， 如 图 2-35 所 示 。 


Download PyCharm 


OS X WINDOWS LINUX 


Professional Community 


Full-featured IDE Lightweight IDE 
for Python & Web for Python & Scientific 
development development 


DOWNLOAD DOWNLOAD 





m m FS 
| Fi - Ivi co 


图 2-35 支持 的 版 本 


默认 是 最 新 版 ， 单 击 “ 下 载 ”按钮 后 会 自动 下 载 ， 如 图 2-36 所 示 。 


新 建 下 载 任 务 b 
Big: | https://download.jetbrains.B686c.com/python/pycharm-col 
SR: | pycharm-community-2016.2.3.exe wer 179.24 MB 


FE: | DAbook 341020 GB v || sw 


Beit 





2-36 下载 PyCharm 及 版 本 
下 载 完成 后 双击 安装 包 即 可 开始 安装 ， 如 图 2-37 所 示 。 
选择 安装 路 径 ， 这 里 使 用 默认 值 即 可 ， 如 图 2-38 所 示 。 
选择 PyCharm 的 位 数 ， 这 里 选择 64 位 ，“.py” 编 辑 器 可 以 根据 需要 进行 选择 ， 如 图 2-39 所 示 。 
安装 过 程 比 较 简单 ， 安 装 完成 后 会 在 桌面 生成 一 个 JetBrains 图 标 ， 双 击 该 图 标 ， 启 动 PyCharm， 首 先 会 进入 环境 配置 界面 ， 如 图 2-40 所 示 。 


接受 协议 ， 如 图 2-41 所 示 。 


B3 PyCharm Community Edition Setup 


Welcome to the PyCharm 
Community Edition setup Wizard 


This wizard will guide you through the installation of PyCharm 
Community Edition. 


Itis recommended that you dose all other applications 
before starting Setup. This will make it possible to update 
relevant system files without having to reboot your 
computer. 


Click Next to continue. 





2-37 ”开始 安装 PyCharm 
PyCharm Community Edition Setup 


Choose Install Location 
Choose the folder in which to install PyCharm Community Edition. 


Setup will install PyCharm Community Edition in the following folder. To install in a different 
folder, dick Browse and select another folder. Click Next to continue. 


Destination Folder 


ram Files (x86) \JetBrains'\PyCharm Community Edition 2016. 2.3 


Space required: 418.4MB 
Space available: 268, 7GB 





图 2-38 选择 安装 路 径 


B3 PyCharm Community Edition Setup 


Installation Options 
Configure your PyCharm Community Edition installation 


Create Desktop shortcut 
| |32-bitlauncher —|4|64-bit launcher 


Create assocdations 


图 2-39 ”设置 安装 选项 





Ld Complete Installation 


lou can import your settings from a previous version of PyCharm. 


Specify config folder or installation home of the previous version of PyCharm: 


@ I do not have a previous version of PyCharm or I do not want to import my settings 


图 2-40 ”没有 PyCharm 的 配置 





Ld PyCharm Community Edition Privacy Policy Agreement 


Please read and accept these terms and conditions: 


JetBrains Privacy Policy 


Last updated: 14th March 2016 


This Policy may be amended from time to time. The respective latest 
version of the policy at the point of time of the purchase/registration of a 
JetBrains Software Product (whichever occurs later) shall apply. The data 
controller is JetBrains s.r.o., Praha 4, Na hřebenech II 1718/10, PSC 147 00, 
Ceská republika. 


In this Privacy Policy, we describe the type af data, including personal data 
(collectively, "data"), that we collect from you when you use our Website 
(listed under JetBrains Website) and certain JetBrains products and 
services as described in this Privacy Policy (collectively, our "services") and 
how we use and disclose that data. The following definitions will be used 
throughout this Privacy Policy. 


xd | Reject and Exit | 





图 2-41 接受 协议 
设置 键盘 的 使 用 习惯 ， 这 里 可 以 选择 “Eclipse” “Visual Studio" 等 ， 如 图 2-42 所 示 。 


接着 设置 样式 及 颜色 ， 如 图 2-43 所 示 。 


PyCharm Community Edition Initial 


im^ 


Keymap scheme: IntelliJ IDEA Classic 


: intelli] IDEA Classic 
IDE theme: 
Emacs 


Editor colors and fonts: Visual Studio 
Eclipse 

Eclipse (Mac OS X) 
You can use File | Settings| NetBeans 


P Click to preview 





图 2-42 ”设置 键盘 的 使 用 习惯 


Keymap scheme: 


IDE theme: 


Editor colors and fonts: Default - 


P Click to preview 


You can use File | Settings to configure any of these settings later. 


ES Ls 





图 2-43 ”设置 样式 及 颜色 


单 击 OK 按 钮 之 后 就 可 以 创建 项 目 、 打 开 项 目 了 ， 如 图 2-44 所 示 。 


lid Welcome to PyCharm Community Edition 


TE Create Tew Project 
L3 Üpen 


时 Check out from Version Control ¥ 


Tk Configure + Get Help ~ 





图 2-44 基本 配置 完成 


单 击 右 下 角 的 Configure 按 钮 ， 也 可 以 进行 配置 ， 如 配置 字体 ， 如 图 2-45 所 示 。 


国 Default Settings 


p Editor » Colors È Fonta } Font 


+] Appearance & Behavior Darcula : 3ave As... 


Keynap 
| Editor 
ced fonts 


+) General - - 
onospaced Size: |12 Line spacing: 1.0 


El Colors & Fonts 
fails, IDE tries to use the secondary one 


eneral 
Language Defaults Enable font ligatures 
Console Colors 
Console Font 
Custom 
Debugger 
Diff & Merge 
VCS 
Python 
Buildout config 
HIML 
Json 
RegExp 
reStructuredIext 
EML 
File Status 
By Scope 

+] Code Style 

Inspections 


Å 


| Cancel | | Apply | | Help | 





图 2-45 “字体 的 配置 


确认 Python 命令 的 路 径 ， 如 图 2-46 所 示 。 


Default Settings 


LQ. ) Build, Execution, Deployment » Console » Python Console For default project 


Editor 
+] Code Style 


+ Environment 


Project: [none] 


Inspections = [rcx xm 
Environment variables: 

















File and Code Iemplates 


Fython interpreter: C: AP ython27 thon. exe kai 
File Encodings Iz ži £ e xk \pyth = 


Interpreter options: | 


Live Templates 
File Types Working directory: 





Emmet Configure Interpreters 


Images 区 | Add content roots to PTIHONPATH 


Intentions [^] Add source roots to PIIHONPAIH 


Spelling 
Starting script 
TODO 
import sys; print Python Ss om Ss X (sys.version, sys. platform) ) 


Plugins sys. path. extend ((WORKING DIR AND PYTHON PAIHS]) 


4] Version Control 
Project Interpreter 
El Build, Execution, Deployment 
El Debugger 
Data Views 
Stepping 
Python Debugger 
Buildout Support 
El Console 
Fython Conzole 
+] Schemas and DIDs 
+] Tools 


ar] 





图 2-46 ”Python 命令 的 路 径 


确认 Git 命 令 的 路 径 ， 如 图 2-47 所 示 。 


国 Default Settings 


Editor 


Ek LE 
ares SSH executable: 


af | 


repositones s 


* synchro 
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图 2-47 Git 命令 的 路 径 


Qi: 


也 可 以 根据 习惯 进行 相应 的 设置 ， 这 里 不 详 述 。 


Linux 的 开发 环境 一 般 是 在 Devstack (专门 用 来 做 OpenStack 开 的 Linux 环 境 ) 上 搭建 的 ， 该 环境 已 经 安装 好 了 Git、Python 包 ,搭建 DevStack 可 以 参考 第 5 章 的 内 容 ， 本 节 内 容 是 基于 DevStack 来 讲解 
的 。 在 Linux 上 做 开发 可 以 直接 使 用 系统 自 带 的 Vim 编 辑 器 ， 也 可 以 使 用 PyCharm 的 Linux 版 本 编辑 器 。 


对 于 新 安装 的 Linux， 可 以 通过 yum 来 安装 Git、Python 等 软件 包 ， 这 里 不 再 详 述 。 


直接 配置 Vim 的 配置 文件 就 可 以 适应 Openstack 的 Python 开发 。 


执行 “vim~/vimrc”， 然 后 输入 如 下 的 内 容 即 可 。 








filetype plugin indent on 
autocmd FileType python setlocal et sta sw-4 sts-4 
set number 
set expandtab 
t tabstop-8 
set shiftwidth-4 
set softtabstop-4 
syntax on 
filetype plugin on 
highlight OverLength ctermbg-red ctermfg-white guibg=#592929 
match OverLength /\%81v.\+/ 
let g:pyflakes use quickfix = 0 
set foldmethod-indent 


set foldlevel-99 













































































保存 并 退出 ， 验 证 Vim 的 开发 环境 。 在 配置 Vim 之 前 ， 按 一 下 Tab 键 ,会 缩 进 8 个 字符 ， 并 且 没 有 行 号 ， 如 图 2-48 所 示 。 


H under the License. 


future _ absolute_import 
Future _ print_function 





在 配置 Vim 之 后 ， 按 一 下 Tab 键 ,会 缩 进 4 个 字符 ， 并 且 有 行 号 显示 ， 如 图 2-49 所 示 。 


13 # under the License. 
14 


15 | future | absolute impart 
1b future | print function 





图 2-49 HARF 


2.2.2 ”PyCharm 编 辑 器 


安装 JDK8 


JDK8 的 网 址 及 下 载 可 以 参考 Windows 的 章节 ， 需 要 注意 的 是 ， 这 里 要 下 载 Linux 的 相关 版 本 ， (jdk-8u101-linux-x64.rpm) ， 如 图 2-50 所 示 。 


bur: oracle.com 


= 


SR: jdk-8u101-linux-x64 .rpm 158.2 


下 载 到 : | DAbook 21523 GB) v 训 览 





图 2-50 ”下 载 的 版 本 
之 后 通过 rpm 命 令 来 安装 JDK， 如 图 2-51 所 示 。 


[root@localhost ~]# rpm -vih jdk-8u101- linux-x64. rpm 
Preparing... IHHHHHHHHHHHHHHHHHHHEHEHHHE [100%] 
Updating / installing... 
1:jdk1.8.0 101-2000:1.8.0 101-fcs  &ESBZIEZE A EHI HH HE HH [1009] 
Unpacking JAR files... 
tools.jar... 
plugin. Jar... 
Javaws.jar... 
deploy.jar... 
rt-jar--. 
jsse.jar... 
charsets. jar... 
localedata. jar... 
[root@localhost ~]# 


图 2-51 开始 安装 
安装 完成 之 后 不 要 忘记 验证 Java 是 否 可 用 ， 如 图 2-52 所 示 。 


[root@localhost ~]# java 
Usage: java [-options] class Largs... ] 
(to execute a class) 
or java [-options] -Jar jarfile Largs... ] 
(to execute a jar Tile) 
where options include: 


-d32 use a 32-bit data model if available 
-d64 use a 64-bit data model if available 
-server to select the "server" VM 


The default VM 1s server, 
because you are running on a server-class machine. 


E2-52 ”JDK 验证 


oor 


前 面 2.1.4 节 详细 介绍 了 PyCharm 的 安装 ， 这 里 不 再 偶 述 。 


2.3 Eclipse 开 上 友 环 境 的 搭建 


从 事 Java 开 发 的 人 应 该 比较 熟悉 ，Eclipse 既 支持 Windows 也 支持 Linux。 下 面 简单 介绍 一 下 在 Eclipse 的 基础 上 安装 PyDev 组 件 来 进行 Python 的 开发 。Eclipse 的 安装 比较 简单 ， 这 里 不 再 乾 述 。 


2.3.1 ”安装 Eclipse 的 PyDev 插 件 


在 Eclipse 窗口 中 ， 单 击 Help 一 Install New Software。 
配置 Eclipse 的 Python Interpreter。 在 Work with 字 段 中 ,输入 “http://pydev.org/updates” 并 单 击 Add 按 钮 。 


选中 PyDev， 单 击 Next 按 钮 ， 直 到 找到 Review Licences 窗 口 ， 接 受 许可 条 款 并 单 击 Finish 按 钮 。 


2.3.0 ”安装 Eclipse 的 EGit 揪 件 


在 Eclipse 窗 口中 ， 单 击 Help 一 Install New Software。 
在 Work with 字段 中 ， 输 入 “http://download.eclipse.org/egityupdates” 并 单 击 Add 按 钮 。 
选中 位 于 Eclipse Git Team Provider 下 面 的 Eclipse EGit。 


单 击 Next 按 钮 ， 直 到 找到 Review Licences 窗 口 ， 接 受 许 可 条 款 并 单 击 Finish 按 钮 。 


2.4 Launchpad 账 号 


24.1 Launchpad 账 号 注册 


Launchpad 是 OpenStack 用 来 托管 其 所 有 项 目的 位 置 。 首 先 需 要 注册 一 个 Launchpad 账 号 ，Launchpad 的 网 址 为 https://launchpad.net/， 其 首页 如 图 2-53 所 示 。 


t 


e 
aP 


Launchpad is a software collaboration 
platform that provides: 


4. Bug tracking 
@ Code hosting using Bazaar 
af Code reviews 
4G Ubuntu package building and hosting 
(9 Translations 
=] Mailing lists 
e Answer tracking and FAQs 
ia Specification tracking 


f$; Take the tour! 


el launchpad 


Log in / Register 


|... Search Launchpad 


39,116 projects, 1,582,236 bugs, 883,318 branches, 2,508 Git repositories, 
2,748,228 translations, 400,359 answers, 71,747 blueprints, and counting... 


Get started 


Creating an account allows you to start working within Launchpad. 
Learn more about Launchpad in the user guide or try it Far yourself in our sandbox 
environment, 


Featured projects 


dm e 





E]2-53 Launchpad ý Ww 


单 击 右上 角 的 Register 链 接 进 行 注册 ， 如 果 有 账号 可 以 直接 登录 ， 没 有 则 可 以 选中 “我 是 一 个 新 的 Ubuntu One 用 户 ”来 进行 注册 ， 如 图 2-54 和 图 2-55 所 示 。 


一 个 账号 登录 Ubuntu 上 的 所 有 服务 


Launchpad > log in with Ubuntu One 


请 输入 您 的 电子 邮件 地 址 ; 


PRAY Bae AR cE 





o 我 是 一 修 新 的 Ubuntu One AR 
四 找 是 老 用 户 ， 找 的 密码 是 ， 


Ubuntu One 是 您 登录 到 所 有 与 
Ubuntu 有 到 服务 的 单一 账号 。 
WARDA Ubuntu 单 点 登录 


KS, AKS HCE 
Ubuntu One RKS. [six eB > 






















































































图 2-54 登录 信息 


Launchpad — create Ubuntu One account 


请 输入 您 的 电子 邮件 地 址 : 
您 的 电子 邮件 地 址 





®© 我 是 一 个 新 的 Ubuntu One AP 


Please tell ys your name, username and choose a 
password: 

















C 我 已 阅读 并 接受 Ubuntu One 服务 条 款 





2.4 Launchpad 账号 


24.1 Launchpad 账 号 注册 


Launchpad 是 OpenStack 用 来 托管 其 所 有 项 目的 位 置 。 首 先 需 要 注册 一 个 Launchpad 账 号 ，Launchpad 的 网 址 为 https://launchpad.net/， 其 首页 如 图 2-53 所 示 。 


Log in / Register 


ys‘ launchpad 


| __[[5earch Launchpad 


Launch pad ls a softwa re collaboration 39,118 projects, 1,582,238 bugs, 583,318 branches, 2,508 Git repositories, 
; . 2,746,226 translations, 400,359 answers, 71,747 blueprints, and counting... 

platform that provides: 

dae Bug tracking Get sta rted 


* Code hosting using Bazaar Creating an account allows vou to start working within Launchpad. 


wf Code reviews Learn mare about Launchpad in the user guide or try it For yourself in our sandbox 
4G Ubuntu package building and hosting environment, 
(9 Translations 

Mailing lists Fea Eu red projects 


@ Answer tracking and FAQs 


lig Specification tracking 
Inkscape 


ig) Take the tour! 





图 2-53 Launchpad ý H 


单 击 右上 角 的 Register 链 接 进 行 注册 ， 如 果 有 账号 可 以 直接 登录 ， 没 有 则 可 以 选中 “我 是 一 个 新 的 Ubuntu One 用 户 ” 来 进行 注册 ， 如 图 2-54 和 图 2-55 所 示 。 
账号 登录 Ubuntu 上 的 所 有 服 多 
Wis tae Ubuntu J ATA Hic 


Ubuntu One 是 您 登录 到 所 有 与 
Launchpad — log in with Ubuntu One Ubuntu 有 有 服务 的 单一 账号 。 


请 输入 您 的 电子 邮件 地 址 ， EMEC a Ubuntu m Ege 


An 


帐号， 该 账号 现 已 昌 名 为 
Ubuntu One 账 号 。 RRES ， 





扰 哇 一 个 新 的 Ubuntu One AR 
9 我 是 者 用户 ， 我 的 密码 是 ， 



















































































Ay? 





图 2-54 登录 信息 


Launchpad — create Ubuntu One account 


请 输入 您 的 电子 邮件 地 址 ; 
您 的 电子 邮件 地 址 





e 我 是 一 个 新 的 Ubuntu One AA 


Please tell us your name, username and choose a 
password: 





















2.4.2 上传 SSH keys 


需要 开发 的 Linux 会 生成 一 对 key， 如 图 2-56 所 示 。 


[rootàlocalhost ~]# ssh-keygen 

Generating public/private rsa key pair. 

Enter file in which to save the key (/root/.ssh/id rsa): 
Created directory '/root/.ssh'. 

Enter passphrase (empty for no passphrase): 

Enter same passphrase again: 

Your identification has been saved in /root/.ssh/id_rsa. 
Your public key has been saved in /root/.ssh/id_rsa. pub. 
The key fingerprint is: 
90:a0:42:ab:fb:d3:90:85:62:96:e0:68:ee:67:79:ed root@localhost. localdomain 
The key's randomart image 1s: 

+--[ RSA 2048]---— 


D 
= 
a 


[rootàlocalhost ~]# 
图 2-56 ”生成 一 对 key 

查看 id_rsa.pub 的 内 容 ， 如 图 2-57 所 示 。 
[rootülocalhost ~]# vi .ssh/id rsa.pub 
ssh-rsa AAAAB3NzaC1lyC2EAAAADAQABAAABAQCf /8UH196u518fgGnOPf gwwo68gqPcc 1 4Yb j KgOk6WawxwwKK4 /T2-hSUSdRFNrXhNBGCJ xxW1a 
EGFUUDuxVWkQmM7K/924FQ8ani1IT-73LPmG9Cpvyml5JIYfAr8kTILeOAqglaV-—--EcDktv3cL xQDL AWcqKow3Sr5/AGc latNroLFtPdBbt5 11Um 
AfByrW/nD7SjtbvmdIV4OhtWwl1WF8gGwV2R6v jOhZeEoxs 6MUf Ah--XR2RFh/vkXaL ZuMEIL4971a5YrzRj xgTU9yFL T41itZpEMOMgi Y5zIZhEzF 
gXPaYESYPpqavr lCmEgC3KxuywHODLSzRH1VFk49YSn82/t root@localhost. localdomain 


图 2-57 pub key 的 内 容 


单 击 SSH keys 页 面 ， 把 id_rsa.pub 的 内 容 上 传 到 Launchpad 的 SSH 页 面 ， 如 图 2-58 所 示 。 


7S AS | 
SSH keys 
"v FA 
SSH keys Import new SSH key 


Insert the contents of your public key (usually “7. ssh/id dsa.pub or /. ssh/id rsa. pub). 
Account activity 
Note: Only SSH v2 keys are supported. 


Public SSH Key: 


al 


G9Cpvymi5JIYFArSKTILeOAqglaV-4--EcDkEv3cLxQ DLAWCqKoW3Sr5/AGclatNroLFEPOBbESLE 
UmAFByrW/nD7SjtbvmdIV4OhtW 1WF8gGwV2R6viOhzZeEoxs6éMUFAh-XR2RFh/vkXaLZuM m 
EIL4971a5YrzRjxgTUSyFLTATiEZpbEMQMgQgiY5zlIZhEzFgXPaYESYPpqavriCmEgC3KxuywHODL Li 


SzRH1VFk49YSn82/t rootGlocalhost localdomain 


E 


Import SSH key 





图 2-58 ”上传 pub key $5 N X 
然后 单 击 Import SSH key 按 钮 ， 完 成 之 后 如 图 2-59 所 示 。 


登录 之 后 会 显示 个 人 信息 页 面 ， 在 下 面 会 看 到 相关 授权 访问 页 面 (可 能 会 有 差异 ) ， 如 图 2-60 所 示 。 


TAES 


y FA 


t SSH keys 


Account activity 


The Following key was added to your account root@localhost. localdomain 


3 root@localhost.localdomain 
Type: ssh-rsa 
Text: AAAAB3NzaC1yC2EAAAADAQABAAABAQCF/8UHIS6USIBFgGnOPF. .. 


Delete Selected Key: 





图 2-59 SSH keys 的 显示 


要 认证 到 的 站 丘 Date 


https://review_openstack.org/ 2016/09/18 
https://wiki.openstack.org/w 2016/08/11 


hEEps://launchpad.net/ 2016/08/11 


图 2-60 ”相关 站 点 


单 击 第 一 行 的 review.openstack.org 页 面 ， 会 出 现 一 个 确认 信息 共享 的 提示 信息 ， 单 击 “ 是 的 ， 我 要 登录 ”按钮 即 可 ， 如 图 2-61 所 示 。 


^ Ad. 


Personal Data Request 


You are logging in to https;//review.openstack org/ 


The site has requested some personal information, please choose what you would like to 
share: 


W Full name: 


W Email address: @awcloud.com 





图 2-61 信息 共享 提示 
登录 之 后 束 可 以 看 到 整个 OpenStack 项 目 代 码 的 情况 ， 如 图 2-62 所 示 。 


oir 


这 里 会 看 有 “+1-1” 的 内 容 ， 是 注册 用 户 对 代码 的 评价 ， 一 般 是 给 “+1”， 如 果 你 认真 看 了 代码 ， 认 为 代码 有 不 要 的 地 方 ， 也 可 以 给 “-1”。 








Üpen Merged Abandoned 


All Hy Projects People Document ation ‘status:open | Search | - 
" openstack 


Search for status:open 


Subject Status Owner Project Branch Undated Size cR VF 
bh Update project documentation formatting Rodolfo Alonso Hernandez openst ack/networking- master (updat e-doc- 3:59 PM w 
ovs-dpdk formatting) 
Remove unnecesary spaces in log Carlos Camacho openstack/puppet- master (space-fix) 3:59 PM | 
messages. ceilometer 
Remove debhelper from install list Thomas Goirand openstack/deb- debian/newton 3:59 PM | -1 
openstack-pkg-tools 
aN alles spaces in log en Catach DD Se ee SEEMS 3:58 PM | 
人 spaces in log Capyos Camacho SURE dak utar (pagi) 3:58 PM | 
Stop plan creation when container exists Julie Pichon opang! ack/python- E able/newt an 3:58 PM = 
tripleoclient (tripleo/re2) 
refactor the class of os installation Zhou Ya OE NIIS master 3:58 PM EN -1 + 
ent spaces in log Carlos Camacho Soir md puppet- master (space-fix) 3:58 PM i 
add support for config generation Jakub Pavlik openstack/salt- master 3:58 PM m *1 
formula-keystone 
3 SETTE "e stable/newton " 
Fix clustered vm live migration audiu Belu openstack/os-win (bug/1618425) 3:57 PM E 1 
ådd the ability to check tenant quota hangu Bt Wl master (bp/ adnin-check- 3:57 PM " 


图 2-62 OpenStack 45 i. E 


2.4.3” 补 元 相关 账号 与 信息 


1.OpenStack 官 方 账号 


除了 Launchpad 账 号 ， 一 般 还 需要 一 个 Openstack 官 网 的 账号 ， 用 于 投票 选举 董事 等 ， 如 图 2-63 所 示 。 


E openstact 


sign in to https://www.openstack.org using your OpenStacklD 


Welcome to OpenStackld! e 
Usemamne 


Password 


|| Remember me for 2 Hours 


Cancel 





Forgot password? 
Register for an OpenStack ID 


Verity OpenStack ID 


图 2-63 ”OpenStack 官 方 账号 界面 


注册 完 之 后 需要 完善 如 图 2-64 所 示 的 信息 。 


| All Ny Projects People Document ation 
openstack Changes Drafts Draft Comments Watched Changes Starred Changes Groups 
Settings 
Profile Pull Name  zhangw 


Preferences Preferred Email | zhangweiüawcloud. com ¥| Register New Email ... | 


Watched Projects 


Contact Information Ihe following offline contact information is stored encrypted. 

WESS WESS Contact information will only be made available to administrators if it 18 

HTTP Password necessary to reach you through non-email based communication. Received 

Identities data is stored encrypted with a strong public/private key pair algorithm, 
and this site does not have the private key. Once saved, you will be 


unable to retrieve previously stored contact details. 
hÀzreementsz a 


lzroupa 


Nailing Address 
Country 


Phone Humber 


Fax Number 





图 2-64 完善 联系 信息 


er 


如 果 不 完 善 联系 信息 ， 则 在 使 用 Git 上 传代 码 的 时 候 会 报错 。 
3. 协 议 信息 


要 上 传代 码 还 必须 同意 协议 ， 单 击 Agreements 页 面 ， 如 图 2-65 所 示 。 


settings 


Status Mame Description 
New Contributor Agreement 


Profile 

Preferences 

Watched Projects 
Contact Information 
SoH Public keye 
HIIP Password 
Identities 

Groups 


Agreement 


图 2-65 “完善 协议 信息 
再 单 击 New Contributor Agreement 页 面 ， 选 中 “ICLA” 单 选 按钮 ， 如 图 2-66 所 示 。 
然后 会 出 现 协 议 的 相关 内 容 ， 还 需要 在 页 面 的 Complete the agreement 文 本 框 中 输入 “| AGREE” 才 能 提交 ， 如 图 2-67 所 示 。 
完成 之 后 会 看 到 一 个 协议 列表 ， 如 图 2-68 所 示 。 
Select an agreement type: 
> ICLA 


üÜpenstack Individual Contributor License Agreement 


System CLA 
DON T SIGN THIS: System CLA lexternally managed) 


USG CLA 
DON T SIGN THIS: 0.5. Government CLA iexternally managed) 


图 2-66 ”同意 ICLA 协 议 


Conplete the agreement: 


pe———————————————— | 


| AGREE (enter I AGREE in the box to the left) 


submit Agreement 











图 2-67 ”同意 协议 


Prafile Status Mame Description 
Verified ICLA  üpenstack Individual Contributor License Agreement 


Preferences 
New Contributor Agreement 


Watched Projects 
Contact Information 
SOH Public Keves 
HITP Password 
Identities 

Groups 


Agreement 2 


图 2-68 ”协议 列表 


2.5 ”Git 的 使 用 


OpenStack 的 代码 托管 在 GitHub 网 站 上 ， 各 组 件 代 码 的 下 载 地 址 是 https://github.com/openstack/ 加 上 组 件 名 称 ， 比 如 keystone 的 代码 下 载 地 址 为 : https://github.com/openstack/keystone, 


2.5.1 ”设置 Git 全 局 配置 


打开 一 个 Linux 终 端 ， 可 以 建立 一 个 单独 的 文件 夹 ， 运 行 : 








gitconfig --global user.name "FirstnameLastname" 
gitconfig --global user.email "your email@youremail.com" 





























这 些 信息 需要 从 https://review.openstack.org/#/settings/ 中 获取 ， 如 图 2-69 所 示 。 





Profile Username Select Username 
Preferences Pull Name 

Watched Projects Email Address Mawe loud. com 

Contact Information Registered Aug 11, 2016 10:12 PM 

SSH Public Keys Account ij 

HITP Password 

Identities 

Groups 

Agreements 


图 2-69 ”填写 信息 的 查看 


2.5.2 ”安装 git-review 工 具 并 验证 


对 于 Ubuntu12.04 或 更 高 版 本 ， 在 一 个 终端 中 运行 sudo apt-get install git-review 命 令 即 可 。 
对 于 Ubunu12.04 之 前 的 版 本 ， 则 运行 sudo pip install git-review 命 令 。 
1. 配 置 您 的 项 目 


打开 一 个 终端 并 转 到 项 目 目录 ， 然 后 下 载 Keystone 的 代码 : 





git clone git://github.com/openstack/keystone.git 
git remote add gerrit \\ 
https: //username(review.openstack.org/openstack/keystone.git 











2. 添 加 远程 仓库 


运行 git review-s 命 令 。 系 统 会 要 求 输入 gerrit 用 户 名 。 输 入 Launchpad id 并 按 下 回 车 键 即 可 完成 git-review 工 具 的 安装 并 验证 。 


2.5.3 ”提交 代码 步骤 


1. 在 launchpad 的 页 面 提 交 bug report 
例如 : 
https://bugs.launchpad.net/keystone 
2.48372) e 


打开 一 个 终端 ， 进 入 keystone 目 录 。 注 意 ， 确 保 位 于 主 版 本 中 ， 且 代码 最 新 。 





git remote update 
git checkout master 
git pull --ff-only origin master 




















为 bug 建 立 一 个 分 支 ， 执 行 如 下 命令 : 


git checkout -b bug/333333 





在 分 支 Bug333333 中 修改 代码 


将 代码 提交 给 Gerrit: 


git add . 





添加 全 部 修改 或 新 增 的 文件 : 





commit -a 
review 


gii 
gi 





ct ct 


在 使 用 HTTP 方 式 review 时 ， 有 可 能 会 遇见 未 认证 错误 ， 此 时 可 以 换 成 SSH 连 接 ， 前 提 是 配置 好 SSH。 


在 社区 账户 里 需要 填写 contact 信 息 





https://review.openstack.org/#/settings/contact 


填写 完毕 后 可 以 提交 。 


之 后 即 可 在 My change 里 查看 自己 提交 的 信息 了 。 


第 一 段 是 一 句 话 的 简介 (标题 形式 ， 不 需要 标点 ) ， 空 一 行 ， 第 二 段 可 以 是 详细 说 明 ， 最 后 一 段 为 Closes-Bug : #xxxxxx 或 Blueprint xxxx。 
Qs 
如 果 在 提交 信息 中 增加 一 个 DocImpact 标 志 ， 在 此 提交 合并 后 可 以 自动 生成 一 个 pug， 所 有 提交 信息 都 会 包含 在 bug 描 述 内 。 


5. 第 二 次 提交 修改 





git commit --amend -a 


如 果 提 交 发 生 冲 突 ， 解决 方法 如 下 : 





# 解决 冲突 


git rebase --abort 
# 暂 存 到 栈 中 
git stash 
切 到 主 分 支 
it checkout master 





H 解决 权限 问题 

sudo chown -Rc SUID .git/ 
# 拉 取 

git pull 

+ 切 回 自己 的 分 支 

git checkout <branch> 
git rebase master 

# 如 果 出 现 问题 解决 后 ， 继 续 
git rebase -continue 

# 从 栈 中 取出 修改 

git stash pop 

# 提交 并 上 传 

git commit -a --amend 
git review 








254 ”Git 管 理 流程 图 


Git 管 理 流程 图 如 图 2-70 所 示 。 
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图 2-70 Gite E LAE A 


2.6 ”本章 小 结 


本 章 主要 讲述 了 在 Windows 及 Linux 操 作 系统 中 Python 开发 环境 的 安装 与 配置 ， 读 者 可 以 根据 自身 的 能 力 及 习惯 来 选择 ， 建 议 使 用 Linux 自 带 的 Vim 作 为 开发 工具 ， 养 成 使 用 Linux 命 令 的 习惯 。 


第 3 章 ” Python 语言 基础 


Python 是 一 种 简单 易学 、 功 能 强大 的 编程 语言 ， 具 有 高 效率 的 高 层 数据 结构 ， 能 够 简单 而 有 效 地 实现 面向 对 象 编程 。Python 简 洁 的 语法 和 对 动态 输入 的 支持 ， 再 加 上 解释 性 语言 的 本 质 ， 使 得 它 在 大 
多 数 平台 的 许多 领域 都 是 一 个 理想 的 脚本 语言 ， 特 别 适用 于 快速 的 应 用 程序 开发 。 


3.1 Python 概述 


Python 是 由 吉 多 . 范 罗 苏 姆 (Guido van Rossum) 于 1989 年 创立 的 语言 。1991 年 初 ，Python 发 布 了 第 一 个 公开 发 行 版 。 目 前 Python 的 版 本 分 为 Python2.x 和 Python3.x (2009 年 ) ， 生 产 环境 中 用 得 
比较 多 的 是 Python2.7， 而 且 Python2.x 和 Python3.x 差 异 比较 大 ， 建 议 大 家 还 是 从 Python2.7 学 起 。 


Python 属于 解释 型 语言 ， 不 产生 目标 机 器 代码 ， 但 会 产生 中 间 人 代码。 中间 代 码 由 软件 解释 器 执行 。 与 编译 型 语言 的 不 同 点 在 于 ，Python 的 每 条 语句 被 逐一 翻译 然后 执行 。 解 释 型 语言 每 执行 一 次 就 番 


译 一 次 ， 因 此 效率 较 低 。 


Python 的 文件 以 “.py” 和 “.pyc” 结尾 ， 其 中 ，“.py” 文 件 是 Python 的 代码 文件 ，“.pyc” 是 “.py” 文 件 执行 编译 之 后 产生 的 字 节 码 文件 。 


Python 源 代 码 .py-> 字 节 人 码 .pyc -> 解释 执行 字 节 人 码 .pyc 














正如 上 面 流程 所 示 ， 使 用 Python 时 ， 每 次 都 需要 将 源 代码 编译 转化 成 字 节 码 ， 再 由 虚拟 机 把 字 节 码 转化 为 机 器 语言 ， 最 后 在 硬件 上 运行 ， 如 图 3-1 所 示 。 


[root&localhost keystone]# 1s 


assignment clean. pyc contrib hacking locale policy service. pyc 
auth cli.py controllers.py 118n.py middleware resource tests 
backends.py | cli.pyc controllers.pyc 118n.pyc mode ls routers.py token 
backends.pyc common credential identity notifications.py  routers.pyc trust 
catalog config.py exception. py _ init__.py notifications. pyc server 
clean. py config.pyc  exception.pyc — init .pyc openstack service.py 

图 3-1 .pyc 文 件 


oor 


本 章 的 代码 均 基 于 Linux 操 作 系 统 ， 使 用 Vim 编 辑 完 成 。 


32 Python 基础 


3.2.4 编码 


为 了 保证 Python 代码 顺利 运行 ， 无 论 是 Linux 还 是 Windows 操 作 系统 ， 所 有 的 Python 文件 编码 格式 最 好 是 unix_utf-8 格 式 ， 所 以 Python 文件 中 指定 编码 格式 为 : 





#-*- encoding: utf-8 -*- 


BY, 








#coding:utf8 








如 果 不 指定 编码 格式 ， 在 代码 中 使 用 中 文 时 会 报 如 图 3-2 所 示 的 错误 。 


[root@localhost ~]# cat test.py 
print "rH 
[rootàlocalhost ~]# python test.py 

File "test.py", line 1 
SyntaxError: Non-ASCII character ‘\xe4' in file test.py on line 1, but no e 
ncoding declared; see http://www.python.org/peps/pep-0263.html for details 
[rootülocalhost ~]# 


图 3-2 中文 错误 提示 


32 Python 基础 


3.2.4 编码 


为 了 保证 Python 代 码 顺 利 运 行 ， 无 论 是 Linux 还 是 Windows 操 作 系统 ， 所 有 的 Python 文 件 编码 格式 最 好 是 unix_utf-8 格 式 ， 所 以 Python 文 件 中 指定 编码 格式 为 : 





#-*- encoding: utf-8 -*- 


BY, 








#coding:utf8 








如 果 不 指定 编码 格式 ， 在 代码 中 使 用 中 文 时 会 报 如 图 3-2 所 示 的 错误 。 


[root@localhost ~|# cat 七 es 七 .DY 


print 
[rootàlocalhost ~]# python test.py 

File "test.py", line 1 
SyntaxError: Non-ASCII character ‘\xe4' in file test.py on line 1, but no e 
ncoding declared; see http://www.python.org/peps/pep-0263.html for details 


[root@localhost ~]# 


图 3-2 ”中 文 错 误 提 


3.2.2 git 


1. 代 码 缩 进 
而 是 采用 缩 进 方式 分 隔 。 为 了 保持 缩 进 的 一 致 性 ，Python 采 用 了 空格 缩 进 ， 而 不 是 Tab 键 缩 进 。 因 此 


在 Python 文件 中 ， 没 有 像 其 他 的 语言 (如 C 语 言 或 者 java 语言 ) 一 样 使 用 人 进行 代码 段 的 分 隔 ， 


规定 在 编写 Python 文件 时 ， 如 果 有 缩 进 ， 下 一 行 应 当 在 禁止 使 用 默认 的 Tab 键 进行 缩 进 。 


前 一 行 的 基础 上 缩 进 4 个 空格 ， 依 次 递增 ， 茜 


正确 的 缩 进 方式 : 





if a: 
«4 个 空格 >print "hello" 





1T 1: 
do something 
1f 0 





do something 
1T 1: 
do something 
do something 


图 3-3” 缩 进 示例 


错误 的 缩 进 方式 : 








if a: 
«tab #>print "hello" 


oor 


这 只 是 Linux 系 统 默 认 的 情况 ， 如 果 按 2.2.1 节 配置 过 vimtc 文 件 ， 








则 可 以 直接 使 用 Tab 键 缩 进 。 


语句 分 隔 
分 隔 的 ， 因 此 ， 两 条 语句 在 Python 中 不 能 写 在 同一 行 上 。 


在 Python 中 ， 两 条 语句 之 间 没有 采用 “; ”进行 分 隔 ， 而 是 采用 换行 进行 


正确 的 写法 : 


print "hell 
print "worl 





PRX 








错误 的 写法 : 
print "hello" print "world" 


但 是 ， 在 Python 中 ， 使 用 “; ”也 并 没有 任何 错误 。Python 保 留 这 个 操作 符 的 唯一 目的 ， 恐 怕 是 为 了 照顾 其 他 语言 开发 者 可 以 快速 上 手 。 在 以 后 的 开发 中 ， 如 果 为 了 保持 几 种 编程 语言 之 间 的 一 致 
性 ， 那 么 可 以 根据 个 人 的 喜好 添加 “; ”分 隔 符 ， 但 是 ， 建 议 不 要 使 用 “; ”分 隔 符 。 


关于 换行 ， 一 般 而 言 ， 尽 量 保证 能 够 在 不 横向 拖 动 鼠 标的 情况 下 看 完 一 行 代码 ， 但 凡事 都 有 例外 ， 有 的 语句 太 长， 这 时 就 需要 换行 。 人 在 Python 中 ， 为 了 表示 上 下 两 行 是 同一 行 ， 需 要 使 用 人 ”符号 在 
行 尾 进行 连接 ， 例 如 : 





print "abcdefghigklmnopqrstuvwXxyzN 
01234567890" 





为 了 阅读 方便 ， 规 定 每 行 代 码 上 的 字符 不 得 超过 90 个 ， 超 过 90 个 之 后 ， 必 须 使 用 人 ”进行 换行 。 


下 面 来 说 一 下 “{}” 的 情况 。 在 Python 中 只 有 一 种 情况 会 使 用 “Qf”， 即 作为 字典 时 才 会 使 用 ; 而 在 其 他 语言 中 ，“f ”常用 于 标示 代码 块 的 功能 。 在 Python 中 标示 代码 块 ， 采 用 缩 进 方式 。 


3.2.3 MANE 


Python 的 命名 规范 : 局 部 变量 由 字母 数字 和 下 划 线 组 成 ， 不 得 以 数字 开头 ， 尽 量 使 用 小 写字 母 ; 全 局 变量 的 命名 规范 与 局 部 变量 类 似 ， 不 同 之 处 是 ， 使 用 大 写字 母 蔡 代 小 写字 母 ;函数 和 方法 的 命名 规 
范 亦 类 似 于 局 部 变量 ， 不 同 之 处 是 ， 词 与 词 之 间 使 用 下 划 线 连接 ， 不 推荐 使 用 大 写字 母 ， 如 没有 特殊 要 求 ， 禁 止 同时 使 用 双 下 划 线 ( — ) 开头 和 结尾 ; 类 的 命名 采用 单词 首 字母 大 写 的 方式 。 


正确 的 命名 方式 : 
1) 局 部 变量 : 
list l,params,ok 3, no 


2) 全 局 变量 : 





PARAMS, ACCEPT 





3) 函数 和 方法 : 


def get current time(): 
pass 





def get now(): 
pass 














class HelloWorld: 





3.24 注释 
Python 中 所 有 的 注释 均 采用 “#” 标示 ， 包 括 大 段 注释 。 


正确 的 小 段 注释 : 





#This is the first programs 


正确 的 大 段 注释 : 











# vim: tabstop-4 shiftwidth-4 softtabstop-4 
# Copyright @ 2016AwCloud 
# 


# Author: xxx 


oor 


大 段 的 注释 还 可 以 使 用 三 引号 ， 但 多 用 于 文档 的 地 方 。 


3.2.5 执行 


输入 Python 与 程序 代码 的 名 称 ， 是 第 一 种 执行 Python 代码 的 方式 ， 第 二 种 执行 方式 是 在 代码 中 写 明 Python 解释 器 的 路 径 ， 直 接 执行 Python 代码 ， 类 型 与 bash 脚 本 一 样 ， 如 图 3-4 所 示 。 


[root@localhost ~]# cat test.py 
£!/usr/bin/python 
£-*- encoding: utf-8 -*- 


print " rx" 


[rootülocalhost ~]# chmod 755 test.py 


[root@localhost ~]# ./test.py 


ic - 
[rootülocalhost ~]# — 


图 3-4 Python 脚本 执行 


第 三 种 执行 方式 是 在 Python 的 shell 符 下 输入 代码 ， 直 接 就 会 输出 结果 ， 如 图 3-5 所 示 。 这 种 方式 的 好 处 是 直接 、 快 捷 ， 但 是 并 不 适合 用 于 编写 程序 ， 并 且 输 入 繁杂 ， 退 出 Python 之 后 ， 代 码 就 没有 了， 


因此 这 种 方式 通常 只 用 于 测试 ， 或 者 验证 某 种 功能 。 

[root@localhost ~]# python 

Python 2.7.5 (default, Jun 17 2014, 18:11:42) 
[GCC 4.8.2 20140120 (Red Hat 4.8.2-16)] on linux? 


Type "help", "copyright", "credits" or "license" for more information. 
1 


>>> X = 
>>> Y= 13 
>>> Z = X+Y 
>>> print z 
25 


图 3-5 Python shell 示 例 


3.2.6 ”代码 的 调试 


Python 中 提供 了 专用 的 调试 工具 。 如 果 要 对 某 个 Python 代 码 文 件 进行 调试 ， 在 命令 行 下 输入 “python-m pdb xxx.py” 即 可 。 常 用 调试 命令 及 说 明 见 表 3-1。 


表 3-1 常用 调试 命令 及 说 明 


ES ES m 
n 执行 下 一 步 p <params> 
b < 行 号 > 在 第 几 行 打 断 点 
c 直接 跳 到 断 点 处 nl 


Python 代码 的 调试 过 程 如 图 3-6 所 示 。 








退出 调试 模式 


说 明 : 

1) | (ist) : 可 以 列 出 当前 将 要 运行 的 代码 块 。 

2) b (reak) : 设置 断 点 , 如 “b6”。 

3) n (ext) : 让 程序 运行 下 一 行 ， 如 果 当 前 有 一 个 函数 调用 语句 ， 用 n 是 不 会 进入 被 调用 的 遂 数 体 中 的 。 
4) c (ont (inue) ) : 让 程序 正常 运行 ， 直 到 遇 到 断 点 。 

5) p: 最 有 用 的 命令 之 一 ， 输 出 某 个 变量 。 

6) s (tep) : 跟 n 相 似 ， 但 是 如 果 当 前 有 一 个 函数 调用 语句 ， 那 么 s 会 进入 被 调用 的 函数 体 中 。 


7) q (uit) : 退出 调试 。 


输出 某 个 参数 或 者 变量 的 信息 


[rootücontrol 一 |]# python -m pdb 3.2.6.py 
> /root/3.2.6.py(3)«module-() 

-> for n in range(2, 10): 

(Pdb) list 


1 #-*- encoding: utf-8 -*- 

2 #!/usr/bin/python 

3 -> for n in range(2, 10): 

4 for x in range(2, n): 

5 if n AX — p: 

6 print n, '"egudls', x, "*'. nsx 

7 break 

8 else: 

9 print n, ‘1S a prime number ' 
| EOF | 
(Pdb) n 


- /root/3.2.6.py(4)«module-() 

-> for x 1n range(2, n): 

(Pdb) b 6 

Breakpoint 1 at /root/3.2.6.py:6 
(Pdb) c 

3 15 a prime number 

> /root/3.2. 6. py C6) «modu le>() 

-> print n, 'equals', x, , n/x 
(Pdb) s 

4 equals 2 * 2 

> /root/3.2.6.py(C/)«module-() 

-> break 

(Pdb) p n 

4 


(Pdb) quit 


图 3-6 ”Python 代码 的 调试 过 程 


3.2.7 ”帮助 的 使 用 


在 Python 提示 符 下 输入 “help” ， 会 提示 如 下 信息 。 











>>> help 
Type help() for interactive help, or help(object) for help about object. 








提示 需要 输入 “help () ”进入 交互 的 帮助 ， 或 者 输入 “help (object) ”来 获取 帮助 。 
1. 交 互 式 帮 助 


按照 提示 ,输入 “help () ”会 出 现 Python 的 帮助 介绍 ， 如 图 3-7 所 示 。 


>>> help) 
Welcome to Python 2.7! This is the online help utility. 


If this 1s your first time using Python, you should definitely check out 
the tutorial on the Internet at http: //docs.python.org/2.7/tutorial/. 


Enter the name of any module, keyword, or topic to get help on writing 
Python programs and using Python modules. To quit this help utility and 
return to the interpreter, just type "quit". 


To get a list of available modules, keywords, or topics, type "modules", 

"keywords", or "topics". Each module also comes with a one-line summary 

of what 1t does; to list the modules whose summaries contain a given word 
such as "spam", type "modules spam". 


图 3-7 help () 提示 
之 后 会 出 现 help 提 示 符 ， 在 输入 提示 信息 中 的 “keywords” 关 键 词 后 会 出 现 如 图 3-8 所 示 的 提示 。 


help> keywords 


Here 15 a list of the Python keywords. Enter any keyword to get more help. 


and elif if print 
as else import raise 
assert except in return 
break exec 15 try 
class finally lambda while 
continue for not with 
det from or yield 
de | global pass 


图 3-8 keywotds 的 帮助 提示 
直接 输入 “if” ， 就 会 出 现 如 图 3-9 所 示 的 帮助 信息 。 
help» 1f 
The 1f statement 


HREM Re ee ee ee i 


The if statement is used for conditional execution: 


if stmt ::= "if" expression “:" suite 
( "elif" expression "2" suite )* 
['else" ":" suite] 


It selects exactly one of the suites by evaluating the expressions one 
by one until one is found to be true (see section *Boolean operations* 
for the definition of true and false); then that suite 1s executed 
(and no other part of the if | statement is executed or evaluated). 
If all expressions are false, the suite of the else clause, if 
present, 15 executed. 
(END) 

图 3-9 if 的 帮助 提示 
输入 q 退 出 if 的 帮助 ， 再 输入 quit 退 出 帮助 。 
2. 直 接 输入 帮助 对 象 


帮助 对 象 可 以 内 置 函 数 名 ， 如 图 3-10 所 示 。 


>>> help(Cid) 
Help on built-in function id in module — builtin -: 


dL...) 
1dCobject) -> integer 


Return the identity of an object. This is guaranteed to be unique among 
simultaneously existing objects. (Hint: it's the object's memory address.) 


图 3-10 ”id 的 帮助 提示 


帮助 对 象 也 可 以 是 Python 语言 的 内 置 关键 词 ， 如 图 3-11 所 示 。 


3.3 ”Python 数据 类 型 


3.3.1 变量 


Python 程序 是 通过 变量 来 访问 某 块 内 存 中 的 数据 的 ， 但 Python 中 变量 的 概念 和 C 语 言 中 的 变量 有 些 不 同 ， 这 里 从 变量 的 定义 上 来 说 明 两 者 的 不 同 之 处 。 在 C 语 言 中 定义 一 个 变量 时 ， 需 要 指定 变量 的 数 
据 类 型 ， 变 量 初始 化 时 ， 还 需 依据 等 号 左边 变量 的 数据 类 型 进行 相应 赋值 ， 否 则 会 出 现 数据 的 转换 操作 ， 造 成 不 可 想象 的 错误 ， 而 在 Python 中 定义 变量 不 需要 指定 变量 的 数据 类 型 ， 可 以 将 各 类 数据 直接 赋 
值 给 等 号 左边 的 变量 ， 比 较 自由 。 例 如 : 























id(y) 
202476598096 








>>> helpí(l1st) 
Help on class list in module _ builtin : 


class list(object) 

| list) -> new empty list 
list(Qrterable) -> new list initialized from iterable's items 
Methods defined here: 


_ add 1i...) 
x. add (y) <==> x+y 


— contains  (...) 
x. contains (y) <==> y in x 


. delitem .(...) 
x. delitem (y) <==> del x[y] 


. delslice (C...) 
x. delslice (1, J) <=> del x[1:]] 


Use of negative indices 1s not supported. 


图 3-11 列表 的 帮助 提示 
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在 Python 中 ， 变 量 的 定义 和 (C 语 言 类 似 ， 一 切 芭 可 是 变量 ， 即 变量 可 以 是 数据 ， 可 以 是 自 定义 的 类 型 ， 也 可 以 是 方法 或 者 函数 。 
1. 变 量 的 命名 规则 


变量 的 命名 规则 : 允许 下 划 线 、 数 字 、 英 文字 母 、 必 须 以 下 划 线 、 英 文字 母 开 头 ， 变 量 名 字 对 大 小 写 敏感 。 


2. 变 量 自动 回收 机 制 


当 变 量 的 引用 计数 变 为 0 时 ，Python 会 自动 回收 ， 如 图 3-12 所 示 。 当 前 的 引用 变量 数 是 2， 当 变量 A 和 变量 B 指 向 其 他 值 时 ， 原 来 值 的 引用 计数 就 变 为 0， 原 来 变量 就 会 被 自动 回收 。 





图 3-12 变量 引用 计数 


Python 的 数据 类 型 同 C 语 言 相 似 ， 区 别 在 于 C 语 言 中 的 变量 一 直 指向 某 地 ， 也 就 是 说 C 语 言 可 以 通过 变量 来 改变 它 指向 内 存 的 值 ， 而 Python 中 变量 变化 的 是 它 的 “指向 ”， 可 以 直接 认为 Python 中 的 变 
量 类 似 于 5 语言 中 指针 的 概念 。 因 此 C 和 Python 中 都 有 变量 的 概念 ， 但 两 种 语言 变量 的 “ 变 ” 的 含义 不 同 。 


3.3 ”Python 数据 类 型 


3.3.1 变量 


Python 程序 是 通过 变量 来 访问 某 块 内 存 中 的 数据 的 ， 但 Python 中 变量 的 概念 和 C 语 言 中 的 变量 有 些 不 同 ， 这 里 从 变量 的 定义 上 来 说 明 两 者 的 不 同 之 处 。 在 C 语 言 中 定义 一 个 变量 时 ， 需 要 指定 变量 的 数 
据 类 型 ， 变 量 初始 化 时 ， 还 需 依据 等 号 左边 变量 的 数据 类 型 进行 相应 赋值 ， 否 则 会 出 现 数据 的 转换 操作 ， 造 成 不 可 想象 的 错误 ， 而 在 Python 中 定义 变量 不 需要 指定 变量 的 数据 类 型 ， 可 以 将 各 类 数据 直接 赋 
值 给 等 号 左边 的 变量 ， 比 较 自由 。 例 如 : 























) 
140202476598096 








>>> help(list) 
Help on class list in module _ builtin : 


class list(object) 

| list() -> new empty list 
listtiterable) -> new list initialized from iterable's items 
Methods defined here: 


.— add 1...) 
x. add (y) <==> x+y 


_ contains .(...) 
x. contains (y) <==> y in x 


. delitem .(...) 
x. delitem (y) <==> del x[y] 


. delslice (i...) 
x. delslice (1, J) <== del x[1:]1] 


Use of negative indices 1s not supported. 


图 3-11 列表 的 帮助 提示 
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Python, SE&BSzEXORHCISESZEAA, JANERE, Mea, SAER, POST AMAR. 
1. 变 量 的 命名 规则 

变量 的 命名 规则 : 允许 下 划 线 、 数 字 、 英 文字 母 、 必 须 以 下 划 线 、 英 文字 母 开 头 ， 变 量 名 字 对 大 小 写 敏感 。 

2. 变 量 自动 回收 机 制 


当 变 量 的 引用 计数 变 为 0 时 ，Python 会 自动 回收 ， 如 图 3-12 所 示 。 当 前 的 引用 变量 数 是 2， 当 变量 A 和 变量 B 指 向 其 他 值 时 ， 原 来 值 的 引用 计数 就 变 为 0， 原 来 变量 就 会 被 自动 回收 。 





图 3-12 变量 引用 计数 


Python 的 数据 类 型 同 C 语 言 相 似 ， 区 别 在 于 C 语 言 中 的 变量 一 直 指向 某 地 ， 也 就 是 说 C 语 言 可 以 通过 变量 来 改变 它 指向 内 存 的 值 ， 而 Python 中 变量 变化 的 是 它 的 “指向 ”， 可 以 直接 认为 Python 中 的 变 
量 类 似 于 5 语言 中 指针 的 概念 。 因 此 C 和 Python 中 都 有 变量 的 概念 ， 但 两 种 语言 变量 的 “ 变 ” 的 含义 不 同 。 


Python 中 的 数字 包含 三 大 类 : 类 整 型 (int, long) 、 类 浮 点 型 (float) 和 复数 。 


Python 的 类 整 型 分 为 int 和 long 两 种 。Python 与 C 语 言 类 整 型 的 区 别 为 : 《语言 整 型 会 有 溢出 的 情况 ， 但 Python 不 会 出 现 溢 出 的 情况 ， 当 低级 类 型 表示 不 了 变量 时 ， 会 自动 向 高 级 类 型 转换 。 使 用 
Python 没有 必要 去 定义 该 类 型 ， 即 范 类 型 ， 如 图 3-13 所 示 。 


>>> l 
1 
>>> Type(1) 
«tvpe ‘int'> 
yp L 
>>> type(1111111111111111111111111111) 
«tvpe “|ong » 
ype 'long 
>>> 
图 3-13 ”变量 自动 扩展 
这 里 补充 一 个 概念 ，Python 的 整 型 缓冲 池 ， 即 对 于 一 定 范围 的 整 型 ，Python 在 内 存 中 提前 进行 了 分 配 ， 不 进行 回收 。 
o 
整 型 缓冲 池 的 范围 可 以 通过 修改 源码 来 更 改 。 
Python 的 类 浮 点 型 为 float。 复 数 的 一 般 形 式 为 3+7j。 
在 OpenStack 开 发 中 用 得 比较 多 的 是 类 整 型 和 类 浮 点 型 ， 复 数 不 常用 。 
2. 表 达 式 
对 于 数字 ， 普 通 的 四 则 运算 本 身 就 是 支持 的 ， 但 是 Python 和 其 他 语言 的 数字 运算 稍微 有 一 点 区 别 。 
区 别 1: 不 支持 自 增 和 自 减 操 作 ， 即 i++、i-- 这 样 的 操作 在 Python 中 是 非法 的 ， 只 能 使 用 ji=i+ 1 或 者 i+ =1 的 方式 ， 如 图 3-14 所 示 。 


区 别 2: 除了 "/" "96" 外， 多 了 一 个 特殊 的 地 板 除 ， 所 谓 地 板 除 指 的 是 除法 中 取 商 的 操作 ， 具 体操 作 如 下 : 


相当 于 取 小 数 点 之 前 的 数 ， 如 图 3-15 所 示 。 


区 别 3: 在 Python 中 ， 关 表示 乘 方 运算 ， 如 2”3->8， 关 前 面 的 数 表 示 底 数 ， 后 面 的 数 表 示 寡 数 ， 如 图 3-16 所 示 。 


>>> result = 1 
>>> result++ 
File “<stdin> , line 1 
resu lta 
A 
SyntaxError: invalid syntax 
>>> result 4-1 
>>> result 
2 


>>> 5/2 
/ 
>>> 5//2 
2 
>> 5.0/2 
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Python 语 言 中 的 其 他 数字 操作 和 其 他 语言 的 数字 操作 一 样 ， 这 里 不 再 歼 述 。 


3.3.3 ”字符 串 和 列表 


字符 串 和 列表 本 来 是 不 同 的 两 种 数据 类 型 ， 但 是 它们 之 间 有 很 多 共性 ， 因 此 这 里 放 在 一 起 讲 。 


1. 字 符 串 和 列表 的 共性 


在 Python 中 ， 字 符 串 有 3 种 表现 形式 : 'abc ，"abc" 和” "abc"”"。 这 3 种 字符 串 都 是 合法 的 字符 串 ， 只 是 使 用 的 场合 不 同 。 单 引号 形式 的 字符 串 和 双 引 号 的 字符 串 基本 相同 ， 只 是 ， 在 处 理 特殊 字符 的 时 
候 ， 双 引号 字符 串 更 加 方便 ， 建 议 大 家 在 平常 的 开发 中 使 用 双 引 号 形式 ; 三 引号 形式 的 字符 串通 常用 于 文档 字符 串 和 SQL 语句 中 。 


Python 中 没有 数组 的 概念 ， 与 之 对 应 的 是 列表 。 这 是 一 种 新 的 数据 形式 ， 一 个 合法 的 列表 如 下 : 





2 








可 以 看 到 ， 列 表 里 面 的 元 素 可 以 是 任意 类 型 的 数据 ， 一 个 列表 并 不 受 限 于 元 素 的 类 型 。 


从 本 质 上 来 说 ， 字 符 串 是 一 类 特殊 的 列表 ， 因 此 ， 列 表 的 大 部 分 操作 同样 适用 于 字符 串 。 下 面 用 一 些 示例 来 说 明 字符 串 (String) 和 列表 的 共同 点 。 


取 下 标 操作 : 
Str awcloud = "awcloud" 
List awcloud = [ Waitt ; Ne 7 We ; MAN r Mol ; Mq ; wel" ] 


print Str awcloud[0] -> a 
print List awcloud [0] -> a 








截取 第 1 个 到 第 4 个 元 素 之 间 的 元 素 : 





print 
print 


Str awcloud[1:4] -> wcl 
List awcloud [1:4] -> ['w', 'c', '1'] 








Ct ct 


截取 第 1 个 到 第 4 个 元 素 之 间 的 元 素 ， 每 隔 2 个 元 素 取 一 次 : 


Str awcloud[1:4:2] -> wl 
List awcloud [1:4:2] -> ['w', '1'] 


print 
print 











取得 某 个 元 素 的 下 标 : 


Str awcloud.index("a") -> 0 
List awcloud.index("a") -» 0 


print 
print 











逆序 取得 某 个 元 素 : 





Str awcloud[-1] -> d 
List awcloud [-1] -> ['d'] 





print 
print 





(十 ct 


追加 元 素 : 





Str awcloud + "678"-» awcloud678 #1 
List awcloud P [6,7,8]€» [var Wy Ta"; "Ly To"; "ut. "a, "12377 ey Ty 8] #2 


print 
print 








Ct ct 


计算 长 度 : 


len(Str awcloud) -> 8 
len(List awcloud) -> 8 


print 
print 














多 次 复制 : 


Str awcloud * 2 -> awcloudawcloud 
List awcloud * 2 一 > ['a', 'w', ro"; E "e s rury *d*, ‘al, ‘wl, tor tr. Tot "ar, 'd] 


print 
print 











复制 : 








Str target - Str awcloud[:] 

List target = List awcloud|:] 

print Str target -> awcloud 

print List target =>=>- La Twy gen, "LN To'y tuts td" | 























请 注意 以 上 加 粗 部 分 ， 加 粗 代码 表示 该 操作 将 返回 一 个 结果 ， 该 结果 由 另外 的 变量 接收 ， 并 不 改变 当前 变量 。 另 外 ， 请 注意 追加 元 素 示例 代码 的 #1 和 #2， 人 列表 没有 “类 型 ”， 但 是 列表 在 进行 运算 时 是 
有 类 型 的 ， 也 就 是 说 列表 的 “+ ”操作 ， 必 须 在 列表 和 列表 之 间 进 行 。 同 样 地 ， 字 符 串 的 “+ ”操作 也 必须 在 字符 串 和 字符 串 之 间 操 作 ， 并 不 支持 不 同类 型 之 间 的 操作 ， 这 点 和 java 不同。 


2. 字 符 串 是 特殊 的 列表 


特殊 性 1: 字符 串 的 值 是 常量 ， 是 不 可 变动 的 ， 而 列表 是 可 更 改 的 。 例 如 ， 








Str awcloud = "awcloud" 

List aweloud = ["a"; aw, rre "I"; n Lag, ee 

可 以 使 用 如 下 代码 : 

List awcloud [0] = "b" -> List awcloud 

将 列表 变更 为 [ "bp” ,"w'"," c ,"V ,"0" ," u", " d" J, 但 若 使 用 下 面 的 代码 : 
Str awcloud[0] = "b" -> 





系统 会 直接 报错 ， 由 于 此 特性 没有 对 字符 串 的 插入 、 追 加 等 操作 ， 这 些 操作 也 不 被 允许 ， 而 列表 则 可 以 进行 这 些 操作 。 








列表 的 追加 : 

List awcloud.append(89) -> List awcloud = ["b","w","c","1","o","u","d", 89] 

在 列表 的 第 1 位 插入 数据 : 

List awcloud[1:1] = [0,9,8] -> List awcloud = ["b", 0,9,8, hg, "gut, TN, Mot ng Mar gg] 


特殊 性 2: 字符 串 只 是 特殊 的 列表 ， 字 符 串 也 是 一 种 数据 类 型 ， 拥 有 自己 的 特殊 函数 和 方法 。 


将 字符 串 进行 大 小 写 转换 : 





Str awcloud.upper() Str_awcloud. lower () 
字符 串 的 追加 : 
"".join([Str awcloud "123"]) 


er 


字符 串 的 值 是 常量 ， 是 不 可 改变 的 ， 因 此 ， 对 字符 串 进行 追加 。 插 入 甚至 修改 ， 操 作 的 都 只 是 字符 串 的 副本 ， 并 不 是 字符 串 本 身 。 





字符 串 有 “+” 操 作 ， 也 有 join 操作 ， 这 两 个 操作 的 执行 结果 是 一 样 的 ， 但 是 ， 从 执行 效率 来 说 ，join 操 作 要 比 “+” 快 ， 因 此 ， 以 后 在 对 字符 串 进行 操作 时 ， 如 果 遇 到 字符 串 的 拼接 操作 ， 建 议 首选 
join 操作 ， 而 不 是 “+”。 


这 里 提出 一 个 优化 原则 : 编写 Python 代码 ， 首 要 目标 是 可 读 性 好 ， 其 次 要 求 执行 效率 高 。 关 于 如 何 提高 Python 的 执行 效率 ， 会 在 后 面 陆续 介绍 。 


特殊 性 3: 列表 也 拥有 自己 的 特殊 方法 。 修 改 一 下 字符 串 和 列表 之 间 的 关系 定义 一 字符 串 和 列表 是 不 同 的 数据 类 型 ， 但 是 ， 二 者 之 间 有 很 多 人 交集， 很 多 方法 可 以 通用 ， 但 是 ， 并 不 是 说 字符 串 就 是 列 
表 ， 字 符 串 和 列表 之 间 没 有 子 集 关 系 。 


关于 字符 串 的 具体 操作 和 特性 可 以 查看 Python 的 帮助 手册 ， 这 里 不 再 介绍 。 
3. 列 表 


首先 ， 看 一 下 如 何 构造 一 个 列表 : 


























List 0 = list("awcloud") 

List 1 = [1,2,3,"awcloud"] 

List 2 = [x for x in range(10)] 
List 3 = [x for x in xrange(10)] 

List 4 = map(lambda x: x,[1,2,3,4,5]) 


以 上 五 句 代 码 ， 功 能 是 一 样 的 ， 都 是 创建 一 个 列表 。 具 体 分 析 如 下 。 


第 一 句 ，List_0=list ( "awcloud" ) ， 实 际 上 是 调用 Python 的 内 置 方 法 list 来 构造 一 个 列表 。 前 面 已 经 学 了 数字 、 字 符 串 和 列表 ， 其 实 ， 这 三 大 类 数据 类 型 都 有 自己 的 内 置 构造 方法 ， 例 如 ，int 类 型 的 
构造 方法 是 int () ， 字 符 串 类 型 的 构造 方法 是 str () ， 而 列表 的 构造 方法 是 list () 。 如 果 需 要 生成 或 者 转换 成 对 应 的 数据 类 型 ， 只 需要 调用 对 应 的 构造 方法 即 可 。 


第 二 句 ， 直 接 进行 初始 化 。 

第 三 句 和 第 四 名 类似， 里 面 涉 及 for 关 键 字 和 其 他 的 一 些 内 置 函 数 。 

第 五 句 直接 使 用 其 他 内 置 函 数 来 构造 一 个 列表 。 

在 以 上 五 名 代码 中 ， 引 入 了 一 些 关 键 字 ， 如 for、in、lambda， 也 引入 了 一 些 内 置 函 数 ， 如 range、xrange 以 及 map。 为 了 更 好 地 理解 以 上 代码 的 功能 ， 下 面 将 详细 讲解 这 几 个 重要 的 关键 字 和 函数 。 


天 键 字 in: 表示 某 个 元 素 存 在 于 另 一 个 元 素 中 。 例 如 : 


"a" in "awcloud" -> True 
"a" in [1,2,3,4,5] -> False 


在 这 个 输出 结果 中 ， 看 到 了 两 个 新 的 关键 字 : True 和 False。 这 两 个 关键 字 用 于 表示 真 和 假 ， 与 C、Java 语 言 中 的 用 法 一 样 。 
天 键 字 for: 用 于 进行 迭代 或 者 循环 的 关键 字 ， 与 C、Java 语 言 中 的 用 法 一 样 ， 唯 一 不 同 的 是 ， 在 Python 中 ，for 关 键 字 需 要 配合 in 关键 字 使 用 。 
例如 : 


for x in [1,2,3] print x 








关键 字 lambda: 构造 一 个 匿名 函数 ， 实 现 简易 的 功能 。 
例如 : 


result = lambda x:x + 1 


等 同 于 





def result(x):return x + 1 





函数 range: 根据 指定 的 参数 返回 一 个 列表 。 例 如 : 


range (10)-> [0, 1, 2, 3, 4, 5, 6, 7, 8, 9] 
range (10,20) -> [10, 11, 12, 13, 14, 15, 16, 17, 18, 19] 
range (10,20,2) -> [10, 12, 14, 16, 18] 














函数 xrange : xrange 的 功能 和 range 的 功能 类 似 ， 不 同 的 是 ，range 一 旦 执行 ， 那 么 生成 的 列表 将 立即 存放 到 内 存 当 中 ， 而 xrange 采 用 了 一 种 类 似 懒 加 载 的 方式 ， 当 xrange 被 执行 时 并 没有 真正 生成 所 
需要 的 列表 ， 或 者 说 生成 的 列表 并 没有 立即 被 放 到 内 存 当 中 ， 只 有 当 生 成 的 列表 被 调用 时 ， 该 列表 才 会 被 依次 展开 。 


因此 ， 这 里 提出 Python 性 能 优化 的 第 二 条 原则 : 在 生成 列表 时 ， 如 果 数 据 量 比较 小 (<5) ， 建 议 使 用 range; 其 他 情况 ， 推 荐 使 用 xrange。 


ERA map: 先 来 看 一 下 map 冰 数 的 定义 。 











map (function, sequence[, sequence, http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/0EBPS/Text/...]) -> list 

















AL, mapka, P-TA, BTSRA TWAS ANWR, EEBSRIBHERZS 7 1-9. 


下 面 来 看 一 下 前 面 提 到 的 列表 构造 的 问题 。 








hist 2 = [x for x in range(10)] 





效果 等 同 于 





List 2= range (10) 

















但 有 不 同 于 : 
List 3 = [x for x in xrange(10) ] 
List 4 = map(lambda x: x,[1,2,3,4,5]) 








List_2 表 示 使 用 range (10) 中 所 产生 的 元 素来 构造 一 个 列表 。List_3 同 第 一 句 ， 只 是 在 内 存 处 理 方面 不 一 样 。List_4 风 是 使 用 map 遂 数 产 生 一 个 列 ， 请 注意 加 粗 部 分 ， 它 们 的 效果 是 等 同 的 ， 但 是 也 存 
在 不 同 之 处 。 


List 2=[x for x in range (10) ] 这 种 语法 形式 叫 作 列表 推导 ， 它 和 数学 中 的 集合 类 似 ， 例 如 ， 该 句 可 以 用 如 下 的 数学 表达 式 表 示 : {XE[0，10) }。 而 List_2=range (10) 则 是 单纯 的 赋值 操作 ， 两 者 的 
性 质 不 一 样 。 在 Python 的 实现 中 ， 列 表 推导 要 比 直接 赋值 来 得 快 。 


因此 ， 在 这 里 提出 Python 性 能 优化 的 第 三 条 原则 : 构造 列表 时 ， 推 荐 使 用 列表 推导 。 


3.34 元 组 


首先 看 一 下 元 组 的 形式 : 





tuple example = (1,2,3,4,5) 





从 形式 上 看 ， 元 组 和 列表 只 是 符号 不 一 样 : 一 个 使 用 ]， 另 外 一 个 使 用 () 。 然 而 ， 元 组 和 列表 不 同 之 处 在 于 ， 列 表 是 可 以 改变 的 ， 可 以 进行 追加 、 插 入 删除 等 操作 ， 但 是 元 组 是 不 能 修改 的 ， 即 对 元 组 
的 追加 、 插 入 和 删除 等 操作 都 是 茶 止 的 。 这 一 点 和 字符 串 比较 类 似 。 可 以 这 么 说 ， 元 组 是 列表 的 常量 版 ， 即 元 组 是 不 可 变 的 列表 。 也 可 以 这 么 说 ， 元 组 可 以 使 用 列表 的 大 部 分 操作 ， 但 是 不 包含 更 改 操作 。 
那么 ， 什 么 时 候 使 用 元 组 ”如 果 打 算 将 一 个 列表 当 作 一 个 参数 传递 给 一 个 函数 ， 但 又 不 希望 修改 列表 的 值 ， 那 么 可 以 使 用 元 组 代替 。 字 符 串 、 列 表 和 元 组 的 关系 如 图 3-17 所 示 。 





图 3-17 FAB. WRF AMMA 


那么 ， 如 何 将 一 个 列表 转换 为 元 组 ”可 以 使 用 如 下 代码 实现 : 





result = tuple([1,2,3,4]) 


3.3.5 ph 


字典 和 Java 中 的 map 类 似 ， 都 是 一 种 键 值 对 的 数据 结构 ， 例 如 : 





dict example= ["jack": 4098, "sape": 4139] 
dict example2- (4: 4098, 6:4139} 











需要 注意 的 是 ， 在 Python 的 字典 中 ， 同 一 个 键 在 一 个 字典 中 只 能 有 一 个 ， 如 果 有 多 余 的 ， 则 直接 报错 ， 或 者 使 用 其 中 一 个 蔡 换 另外 一 个 。 必 须 注意 的 是 ， 字 典 的 键 必 须 是 可 hash 的 数据 类 型 ， 在 
Python 中 ， 可 hash 的 数据 类 型 只 有 几 种 : 类 int 型 、 类 float 型 、string 型 。 因 此 ， 字 典 只 能 使 用 这 几 种 数据 类 型 作为 键 ， 不 允许 使 用 其 他 的 数据 类 型 。 好 在 字典 的 键 对 应 的 值 没有 限制 ， 因 此 ， 在 字典 中 ， 
对 应 的 值 可 以 存放 任意 数据 ， 包 括 类 型 、 方 法 、 类 等 。 


字典 的 基本 操作 也 和 Java 中 的 map 一 样 。 


dict test= {"java":1024,5:2048,1.2:78} 





取出 字典 中 指定 键 的 值 : 





dict test["java"] -> 1024 
dict test[5] -» 2048 
dict test[1.2] -> 78 

















向 字典 新 添加 一 个 键 值 对 : 


dict test["new"] = "float" -> {"java":1024,5:2048,1.2:78, "new" :"float"] 








更 新 一 个 键 值 对 : 

















dict test[5] = "float" -> ("java":1024,5:"float",1.2:78,"new":"float"] 


还 有 一 点 需要 注意 ， 字 典 中 没有 索引 的 概念 ， 因 此 千 万 不 要 和 列表 混淆 了 。 


3.3.0 ”其 他 类 型 


在 Python 的 常用 数据 类 型 中 ， 还 有 一 种 比较 常用 的 数据 类 型 : 集合 (set) 。 集 合 与 列表 类 似 ， 但 它 也 有 自己 的 表现 形式 。 





list test = [1,2,3, 
[[1, 


1,4, 
set test = set([[1,2,3, 12,3]]) => set([1,2,3,4,6]) 





也 就 是 说 ， 列 表 中 可 以 存放 相同 的 元 素 ， 但 是 在 集合 中 ， 相 同 的 元 素 只 能 保存 一 份 ， 即 在 集合 中 不 存在 重复 的 元 素 。 从 存储 的 角度 来 看 ， 一 个 Python 中 的 列表 更 像 一 个 散 列 表 ， 它 的 存储 空间 可 能 会 根 
据 内 存 的 分 配 不 同 是 分 散 的 ; 但 是 集合 不 同 ， 集 合 在 内 存 中 的 存储 空间 是 连续 的 ， 因 此 ， 从 执行 效率 方面 来 讲 ， 一 个 集合 会 比 一 个 列表 快 很 多 ， 而 且 有 可 能 会 节省 很 多 空间 。 


还 需要 注意 的 是 ， 集 合 和 列表 只 是 相似 ， 这 并 不 意味 着 列表 的 方法 就 适用 于 集合 。 例 如， 集合 不 支持 取 下 标 操作 。 


3.4 ”流程 控制 


常用 的 流程 控制 语句 如 下 : if...else...、if...elif...else、while 循 环 、for 循 环 、try...cache...finally 等 。 为 了 更 好 地 理解 流程 控制 ， 下 面 以 boo| 类 型 为 例 进行 讲解 。bool| 类 型 的 值 只 有 两 个 : True 和 False。 
然而 ， 和 Java 不 同 的 是 ， 在 Python 中 ， 还 有 扩展 的 bool 类 型 : 非 空 值 或 者 非 0 值 为 True， 空 值 或 者 0 值 为 False。 


特殊 的 类 型 : None。None 表 示 空 ， 和 Java 中 的 null、C 中 的 NULL 一 样 ， 这 个 值 的 bool 属 性 是 False。 


3.4.1 ”if 语句 


常用 的 判断 语句 为 ifhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/17414/OEBPS/Text/...elsehttp://www.hzcourse.com/resource/readBook? 


pathz/openresources/teach ebook/uncompressed/17414/OEBPS/Text/..., AN : 


debug = False 

if debug: 

print "++4++++4+++" 

else: 
print "=========" 





debug = None 
if debug: 
print "二 十 十 十 十 十 十 二 十" 
else: 

print WH 








debug = 0 

if debug: 

print "++4++++4+++" 

else: 
print "=========" 








debug = "" 

if debug: 

print "二 十 十 十 十 十 十 二 十" 

else: 
print "=========" 








debug = [] 

if debug: 

print "二 十 十 十 十 十 十 二 十" 

else: 
print "=========" 








debug = {} 

if debug: 

print "++++++4+++" 

else: 
print i 








当 出 现 多 重 判断 的 时 候 ， 在 Java 和 C 语 言 中 ， 一 般 使 用 if...else if.….else 来 进行 处 理 。 和 其 他 语言 不 一 样 ，Python 并 没有 相同 的 控制 结构 ， 取 而 代 之 的 则 是 if...elif...else， 这 一 点 请 牢记 。 


Python 中 不 支持 switch 语 法 。 前 面 讲解 字典 的 时 候 ， 提 到 字典 的 值 可 以 是 任意 类 型 ， 基 于 此 ， 如 果 Python 中 需要 实现 多 分 支 判断 操作 ， 那 么 有 两 种 方式 可 供 选 择 : 使 用 if...elif...else， 或 者 使 用 字典 。 
下 面 是 使 用 字典 的 代码 示例 。 


def hello(): 
pass 
def world(): 

pass 
operation = ("first":hello, "second":world} 























operation [key] () 


在 以 上 这 段 代 码 中 ， 只 需要 指定 key， 便 可 以 执行 不 同 的 代码 ， 实 现 与 swich 语 句 相 同 的 功能 。 注 意 ， 在 实现 多 分 支 操作 的 时 候 ， 使 用 if...elif.…else 会 进行 额外 的 操作 ， 因 此 这 种 方式 的 执行 效率 会 比 使 
用 字典 的 方式 慢 。 


这 里 提出 Python 性 能 优化 的 第 四 条 原则 : 处 理 多 分 支 语句 时 ， 如 果 分支 数 大 于 4， 那 么 推荐 使 用 字典 的 方式 来 实现 。 


3.4.2 while 循环 


while 循 环 在 Python 中 的 使 用 和 其 他 语言 一 样 ， 这 里 不 再 赣 述 。 下 面 只 说 一 个 重点 ， 在 Python 中 ， 有 时 为 了 某 个 特殊 目的 ， 会 构造 一 些 死 循 环 ， 例 如 : 


while True: 
do something 


在 前 面 讲 了 Python 的 poo| 类 型 包含 了 True 和 False， 以 及 类 型 的 bool 属 性 。 实 际 上 ， 在 Python 解释 器 ( 某 些 平台 上 ) 中 ，bool 类 型 被 解释 为 int 类 型 ， 因 此 ， 在 执行 判断 时 ，Python 判 断 int 类 型 比 判 断 
True 和 False 要 快 。 


所 以 ， 在 这 里 提出 Python 性 能 优化 的 第 五 条 原则 : 在 构造 死 循 环 时 ， 使 用 int 类 型 会 比 直接 使 用 bool 类 型 快 。 例 如 : 


while 1: 
do something 


3.4.3 for 循环 


在 前 面 已 经 简要 地 提 到 了 for 循 环 ， 在 Python 中 ，for 需 要 和 in 关键 字 联合 使 用 。 和 其 他 语言 的 for 循 环 相 比 ，Python 中 的 for 循 环 更 加 类 似 于 Java 中 的 
forhttp://www.hzcourse.com/resource/readBook?path-z/openresources/teach ebook/uncompressed/17414/OEBPS/Text/...each 的 语法 ， 只 是 功能 更 加 强大 。 下 面 介 绍 几 种 for 循 环 的 基本 使 用 方 
法 。 
for x in "awcloud": 
print x 


for x inm [1,2,3,4]: 
print x 








for x,y in [[1,2], [3,4]] : 
print x,y 


for x,y,z im [1122,3],;14,5,6]]3 
print x,y,z 





for x in set([1,2,3,4]): 
print x 








for x in (1,2,3,4): 
print x 


请 注意 加 粗 部 分 的 代码 ， 这 是 Python 独 有 的 一 种 语法 。 


这 里 提出 Python 性 能 优化 的 第 六 条 准则 : 尽量 使 用 Python 的 特性 ， 使 用 单 层 循环 替代 多 层 伐 套 循环 。 


3.44 _ continue 和 break 


和 其 他 语言 一 样 ， 为 了 控制 循环 语句 ，Python 也 提供 了 continue 和 break 关 键 字 。 它 们 的 具体 用 法 在 这 里 不 再 多 说 。 需 要 注意 的 是 ，Python 和 其 他 语言 一 样 ， 都 有 goto 语 法 ， 但 是 强烈 建议 大 家 不 要 
使 用 goto 关 键 字 及 类 似 语法 ， 这 种 写法 只 会 让 程序 更 加 难以 理解 。 


34.5 FENNE 


和 Java 一 样 ，Python 提 供 了 异常 处 理 机 制 ， 使 用 try.…catch...finally 进 行 相关 的 处 理 。 


try: 

do correct thing 
catch error or exception,e: 
#catch Exception: 

do error handling 
finally: 

do other things 








可 以 看 到 ， 这 种 处 理 方式 和 Java 中 的 一 样 ， 但 是 请 注意 加 粗 部 分 ， 这 两 种 方式 都 是 合法 的 ， 但 是 注释 中 的 语句 并 没有 带 上 异常 或 错误 的 变量 ， 这 种 类 型 的 catch 子 句 称 为 裸子 句 。 裸 子 句 在 现在 的 标准 中 
是 正确 的 , 但是， 在 pep ( 即 Python 编 码 规范 ) 中 ， 有 人 建议 取消 这 种 类 型 的 catch 子 句 ， 因 此 ， 为 了 保证 程序 的 兼容 性 ， 要 求 禁止 使 用 catch 裸 子 句 。 


在 Python 中 ， 不 仅 可 以 使 用 try.…catch...finally 进 行 错误 处 理 ， 也 可 以 使 用 只 包含 try 和 finally 的 形式 来 处 理 错误 。 


try: 
do something 
finally: 

do other thing 





这 种 形式 的 语句 表示 处 理 正常 的 情况 ， 如 果 出 现 错误 情况 ， 不 做 任何 处 理 ， 但 是 要 保证 扫尾 工作 的 正常 进行 。 


3.4.6 ”else 的 特殊 用 法 


先 看 一 段 代码 : 





for x in list test: 

print x | 
else: 
print "list is empty" 











这 段 代 码 的 意思 是 循环 输出 list_test 中 的 元 素 ， 如 果 list_test 为 空 ， 那 么 就 直接 提示 list_test 为 空 。 完 整 的 语句 表达 如 下 : 





if list test: 

for x in list test: 
print x | 

else: 
print "list is empty" 
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再 来 看 一 个 例子 : (SERRA ( 欧 几 里 德 算法 ) 输出 2 ~ 10 之 间 的 最 大 公约 数 。 


for n in xrange(2, 10): 
for x in xrange(2, n): 
if n% x == 0: 
print n, 'equals', x, '*', n/x break 

















else: 
print n, 'is a prime number' 


在 这 种 地 方 灵活 使 用 else 子 句 ， 将 大 大 减少 由 于 if 判断 带 来 的 时 间 消 耗 ， 并 且 语 句 也 更 加 精炼 。 


虽然 Python 是 完全 面向 对 象 的 编程 语言 ， 但 是 Python 同样 支持 函数 式 编程 ， 而 且 Python 的 函数 式 编 程 并 不 比 其 完全 面向 对 象 编程 速度 慢 、 功 能 弱 。 如 果 有 兴趣 ， 完 全 可 以 使 用 函数 来 代 蔡 类 。 


3.5.1 ”函数 基础 


先 来 看 一 看 什么 是 函数 : 








def greeting (name): 
print "Hello,%s" $ name 





上 边 这 段 代码 定义 了 一 个 简单 的 函数 ， 先 看 一 下 定义 函数 的 普通 模板 : 








def functionname (params): 
statment 








关键 字 def 表 示 定 义 一 个 函数 ， 后 面 还 会 介绍 使 用 这 个 关键 字 来 定义 方法 。 只 要 定义 一 个 函数 ， 那 么 就 必须 使 用 def 关 键 字 ， 并 且 需 要 注意 ，def 关 键 字 只 能 用 于 定义 函数 和 方法 ， 不 能 用 在 其 他 地 方 。 


functionname 表 示 国 数 的 名 字 ， () 表示 这 是 一 个 方法 ，params 表 示人 参数 。 注 意 ， 这 里 的 params 没 有 “类 型 ”， 只 有 在 运行 函数 时 ， 才 能 确定 params 的 类 型 。statement 表 示 代 码 块 。 


3.5.2 RBS 


还 记得 前 面 讲 到 的 range 国 数 吗 ? 


range (10) 
range (10, 20) 
range (20,30,2) 





一 


这 3 种 调用 方式 都 是 合法 的 。 这 看 起 来 就 像 是 Java 的 方法 重 载 ， 使 用 相同 的 函数 名 ， 参 数 个 数 不 一 样 而 已 。 下 面 是 Java 的 代码 : 





def greeting (name): 
pass 





def greeting (name,age): 
pass 














def greeting (name,age,cla): 
pass 


但 是 这 样 的 方式 用 在 Python 中 是 完全 错误 的 。 Python 并 不 支持 函数 或 者 方法 重 载 。 那 么 ， 使 用 什么 方式 可 以 达到 类 似 方法 重 载 的 功能 ”答案 是 参数 。 


在 Python 中 ， 函 数 和 方法 的 参数 是 一 个 相当 重要 的 概念 ， 可 以 说 参数 是 函数 和 方法 的 灵魂 。 下 面 来 看 一 下 函数 的 参数 有 哪 几 种 : 





def greeting (name,age,cls-"",*arg,**karg): statment 


当 一 个 函数 或 方法 有 多 个 参数 时 ， 使 用 “，” 作 为 分 隔 符 将 参数 分 开 ，name 和 age 这 两 个 参数 的 性 质 是 一 致 的， 称 为 普通 参数 或 者 位 置 参数 。 这 种 参数 人 在 调 用 函数 或 者 方法 时 必须 传 入 ， 否 则 将 会 出 现 
调用 错误 。 


cls 称 为 关键 字 参 数 或 者 默认 参数 ， 在 进行 函数 或 者 方法 调用 时 ， 这 是 一 个 可 选 的 参数 。 

带 两 个 “*” 符 号 的 参数 称 为 关键 字 参 数 ， 和 和 cls 关键 字 参数 不 一 样 ， 指 的 是 那些 函数 中 存在 ， 但 是 不 知道 具体 名 称 的 关键 字 参 数 。 

带 一 个 “”” 号 的 参数 称 为 位 置 参 数 ， 但 这 个 位 置 参 数 和 前 面 的 位 置 参数 不 太一 样 ， 指 的 是 那些 函数 中 存在 ， 但 是 不 知道 具体 名 称 的 位 置 参数 。 
需要 注意 ， 定 义 浮 数 或 者 方法 时 ， 参 数 的 排列 顺序 必须 是 位 置 参 数 、 关 键 字 参数 、* 参 数 和 ** 参 数 ， 这 个 顺序 不 能 变 ; 同时 位 置 参 数 是 必须 传 入 的 。 


如 果 把 上 边 的 函数 或 方法 改 成 下 边 这 种 形式 : 








def greeting(*arg,**karg): statment 


表示 这 个 函数 或 方法 可 以 接收 任意 个 数 的 任意 类 型 参数 。 


型 参数 。 这 种 类 型 的 函数 或 者 方法 通常 用 于 记录 日 志 或 者 闭 包 函数 及 方法 。 这 是 比较 重要 的 一 种 函数 形式 ， 在 以 后 的 讲解 中 将 经 常 遇 到 类 似 的 函数 或 者 
方法 。 注 意 ， 这 里 的 参数 指 的 是 在 函数 或 者 方法 进行 定义 时 的 参 ; 


数 ， 下 面 讲 另 一 种 模式 的 参数 。 


先 来 看 这 么 一 段 代 码 : 





def hello (name,age-10): 
print "Hello,%d old friend named $s" $(age,name) 
































hello ("awcloud", 20) 

hello ("awcloud", age=20) 

hello (name="awcloud", age=20) 

hello (age=20, name="awcloud") 

params | list = ["awcloud", 20] 

hello (*params list) 

params : dict = {"name":"awcloud", "age":20} 
hel o(**params . dict) 





上 边 的 代码 中 定义 了 一 个 名 为 hello 的 函数 ， 这 个 函数 接收 两 个 参数 ， 即 一 个 位 置 参 数 name， 一 个 天 键 字 参数 age。 第 一 次 调用 的 时 候 ， 完 全 采用 和 Java 中 的 相同 方式 ;第 二 次 调用 的 时 候 ， 采 用 加 上 
关键 字 参 数 名 的 方式 ;第 三 次 调用 的 时 候 ， 采 用 加 上 所 有 参数 名 的 方式 ;第 四 次 调用 时 ， 采 用 加 上 参数 名 ， 并 且 顺 序 颤 倒 的 方式 ， 第 五 次 调用 的 时 候 ， 采 用 * 的 方式 ;最 后 一 次 调用 的 时 候 ， 采 用 和 的 方式 。 


先 说 前 面 4 种 方式 ， 强 调 一 点 ，Python 的 函数 和 方法 接收 参数 的 时 候 ， 如 果 不 指定 参数 名 ， 默 认 是 按照 参数 的 位 置 依次 接收 的 ， 但 是 如 果 指 定 了 参数 名 ， 会 完全 按照 参数 名 来 接收 参数 。 因 此 在 Python 
中 函数 和 方法 的 参数 名 相当 重要 。 


现在 看 最 后 两 种 方式 ， 在 使 用 * 的 方式 之 前 ， 构 造 了 一 个 列表 ; 在 使 用 ** 的 方式 之 前 ,构造 了 一 个 字典 。hello (*params list) 这 一 句 中 的 * 和 函数 定义 时 不 一 样 ， 不 再 表示 位 置 参 数 ， 而 是 表示 一 个 解 
包 操作 ， 表 示 将 一 个 列表 按照 顺序 解 开 ; 同 理 ，** 的 方式 也 不 再 表示 关键 字 参 数 ， 而 是 表示 一 个 解 包 操作 ， 表 示 将 一 个 字典 按照 顺序 解 开 。 解 开 之 后 的 操作 是 怎样 进行 的 呢 ? 


列表 解 开 之 后 ， 按 照 位 置 参数 的 形式 ， 依 次 向 函数 传递 参数 ， 因 此 ， 如 果 采 用 * 的 方式 传递 参数 ， 那 么 在 构造 的 列表 中 ， 参 数 的 顺序 一 定 要 正确 无 误 ; 字典 被 解 开 之 后 ， 按 照 关 键 字 参数 的 形式 向 函数 传 
递 参 数 ， 因 此 ， 在 使 用 ** 的 方式 传递 参数 时 ， 必 须 保证 字典 的 键 一 定 要 和 遂 数 中 参数 的 名 称 对 应 起 来 。 


3.5.3 ”函数 体 和 返回 值 


现在 看 一 下 其 他 阔 数 相关 的 问题 ， 先 看 两 段 函数 : 


def get max (numberl,number2): 
if numberl > number2: 

return numberl 

else: 
return number2 

















def print list(params list): 
for param in params list: 
print param 








在 这 两 段 函数 中 ， 第 一 段 函 数 用 了 一 个 关键 字 return， 第 二 段 函数 没有 采用 return。 这 种 形式 和 Java 中 有 返回 值 和 无 返回 值 的 情况 一 样 ， 区 别 在 于 Java 中 定义 返回 值 需要 使 用 类 型 描述 符 ， 如 int、 
String 之 类 ， 而 在 Python 当中 ， 统 一 采用 def 进 行 函数 定义 ， 有 无 返回 值 ， 全 看 代码 段 中 的 return 关 键 字 。 


在 Java 中 ， 经 常 看 到 有 一 些 方法 没有 函数 体 ， 确 切 地 说 是 没有 函数 内 容 ， 那 么 ， 在 Python 中 如 何 创建 这 样 的 函数 呢 ? 














def nothing func(): 
pass 


passim Be, passZ eh FRIAS. KREET AER, (ARM. fEtryhttp;//www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/17414/OEBPS/Text/..catchhttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/17414/OEBPSVText/.. 中 也 经 常 使 用 pass 来 忽略 某 些 操作 。 


try: 
do something 
cache Exception: 
pass 
finally: 
do something 











当然 ，psaa 也 可 以 用 到 循环 当中 ， 这 里 就 不 再 详细 讲解 了 。 


3.5.4 ”再 论 类 型 和 循环 


前 面 介绍 了 Python 的 基本 类 型 ， 其 中 list、tuple、string、dict、set 等 类 型 都 是 Python 的 集合 类 型 ， 这 些 类 型 都 有 一 个 公共 点 ， 即 它们 都 是 可 和 迭代 类 型 。 下 面 给 出 可 友 代 类 型 的 粗略 定义 : BAH 
是 一 种 集合 类 型 ， 这 种 类 型 本 身 或 者 稍 加 改造 就 支持 循环 操作 。 在 Python 中 ， 可 和 迭代 类 型 包含 : list、tuple、string、dict 和 set 等 集合 类 型 ， 其 他 的 集合 类 型 ， 文 件 和 类 文件 对 象 ， 输 入 /输出 流 以 及 生成 
器 。 


在 讲解 这 些 之 前 ， 先 来 学 习 一 个 非常 重要 的 函数 





type 函 数 。type 函 数 的 作用 很 多 ， 这 里 讲解 它 最 主要 的 功能 : 返回 传 入 参数 的 类 型 。 





type([x for x in xrange(100)]) 
type ("string") 








Python Past TREAS, BEET RN EAR MOEN. WISREÉSROISEETRARBJEIRAEABUASES, uILABRdtypelSZICK Erg. 


TARAH ARSE, list, tuple. string, setixJ LMEGERE E RTL LESSE (BUE SNB, BAF HdictiZWaeTA Eh? 假设 现在 有 一 个 字典 ， 里 边 有 很 多 数 
对 ， 可 以 采用 以 下 方式 : 


inii 
eet 
时 
di 
xf 
Il 
fi 
jun 








I4: 

for key in dict test: 
print key 

Jake: 








for number,name in dict test.iteritems(): 
print number, name 


采用 第 一 种 方式 ， 能 获得 字典 的 键 ; 采用 第 二 种 方式 ， 可 以 一 次 性 获得 该 字典 的 键 和 值 。 


请 注意 代码 中 的 加 粗 部 分 ， 这 是 第 一 次 接触 到 这 种 形式 的 for 循 环 ， 这 种 形式 也 是 合法 的 for 形 式 。 例 如 : 


list test = [("awcloud",12,"network"), ("awcloud eng",13,"storage")] 
for name,code,typ in list test: 
print name, code, typ 








输出 结果 如 下 : 


awcloud 12 network 
awcloud eng 13 storage 





HARARE SRATR ETARA, TEREGSSEÓDCEUSCERSRU, 3EARILOEDHECGWROHSRÓE. Sb, Python igna. AT BIST RK, BRR: 


tuple test- ("awcloud",12,"network") 
name, code, typ tuple test 








注意 ， 这 种 形式 的 代码 是 完全 合法 的 ， 它 的 意思 是 ， 把 tuple_ test 的 第 一 个 元 素 赋 给 name， 把 第 二 个 元 素 赋 给 code， 把 第 三 个 元 素 赋 给 typ。 由 于 Python 具有 这 样 的 特性 ， 因 此 常见 的 值 交换 的 操作 可 
以 这 样 进行 : 


这 样 的 代码 也 是 合法 的 ， 上 边 这 段 代 码 的 执行 结果 是 a 的 值 变更 为 24，b 的 值 变更 为 12。 这 种 方式 减少 了 使 用 局 部 变量 带 来 的 内 存 消 耗 和 性 能 损失 ， 因 此 推荐 使 用 这 种 方式 。 


有 了 以 上 的 了 解 ， 下 面 继续 来 介绍 类 文件 类 型 和 输入 /输出 流 。 在 实际 的 使 用 中 ， 类 文件 类 型 可 以 划分 到 输入 /输出 流 中 ， 现 在 重点 讲解 类 文件 类 型 。 和 其 他 的 语言 一 样 ，Python 也 有 文件 类 型 的 处 理 ， 
而 且 和 其 他 语言 中 的 操作 方式 一 样 。 








file obj = open (file path, "r|w|ab+") 





上 边 的 代码 创建 了 一 个 文件 对 象 ， 其 中 “r、w、ab+” 表 示 以 什么 方式 打开 文件 ， 这 里 不 再 细 述 。 主 要 看 一 下 文件 对 象 的 使 用 : 


方式 1: 





file obj = open( file ,"rb") 
for line in file obj.readlines(): 
print line 











方式 2: 





file obj = open( file,"rb") 
for line in file obj: 
print line 











这 两 种 方式 代码 的 运行 效果 是 一 样 的 ， 但 是 ， 请 注意 加 粗 部 分 ， 方 式 1 的 代码 执行 加 粗 部 分 之 后 ， 文 件 会 在 内 存 中 被 全 部 展开 ; 而 方式 2 的 代码 则 不 一 样 ， 当 使 用 到 哪 一 行 的 时 候 ， 才 把 据 定 行 在 内 存 中 
展开 。 因 此 ， 从 内 存 角度 来 看 ， 方 式 1 比 方式 2 更 加 节省 资源 ; 从 类 型 的 角度 来 看 ， 方 式 1 的 代码 是 把 文件 对 象 当 作 列表 在 使 用 ， 而 方式 2 的 代码 则 把 文件 对 象 当 作 可 运 代 对 象 或 者 生成 器 进行 处 理 。 


在 这 里 ， 提 出 Python 性 能 优化 的 第 七 条 准则 : 在 处 理 文件 对 象 时 ， 应 该 统一 将 文件 对 象 当 作 可 和 迭代 对 象 或 者 生成 器 进行 处 理 。 


无 论 采 用 什么 语言 ， 在 处 理 文 件 的 时 候 ， 都 会 有 异常 处 理 ， 例 如 ， 在 Java 中 经 常 采 用 try…catch.… 进 行文 件 异 常 处理 。 同 样 地 ， 在 Python 中 也 会 遇 到 与 文件 相关 的 异常 ， 例 如 : 





try:do something with file object 


cache: exception 
finally:close file 











看 一 下 Python 的 另 一 种 语法 : 





with open(file path,"rb") as file obj: 
for line in file obj: 
print line 














with…as… 语 法 默认 包含 了 异常 处 理 ， 表 示 只 要 不 发 生 相关 的 异常 ， 就 执行 with 语法 块 所 包含 的 部 分 ; 如 果 发 生 异 常 ， 则 跳 过 该 段 代 码 。 这 种 语法 形式 常常 用 于 只 需要 进行 try 和 finally 块 处 理 的 操作 ， 
对 于 其 余 如 需要 在 catch 块 中 进行 处 理 的 操作 ， 则 并 不 适合 。 


当然 ，with.…as… 语 法 不 仅 可 以 用 于 file 对 象 的 处 理 ， 也 可 以 用 于 其 他 有 异 弟 处 理 的 场景 。 


3.5.5 ”生成 器 


下 面 首先 给 出 生成 器 的 定义 : 生成 器 是 一 次 生成 一 个 值 的 特殊 类 型 函数 ， 可 以 将 其 视 为 可 恢复 函数 。 调 用 该 函数 将 返回 一 个 可 用 于 生成 连续 x 值 的 生成 器 。 


这 个 定义 比较 绕 口 ， 下 面 来 做 一 个 形象 的 比较 。 


int get next () 


static int number = 1; return number++; 


上 边 是 一 段 简 单 的 c 语 言 代码 ， 它 的 功能 是 只 要 程序 不 退出 ， 就 一 直 返 回 静 态 变 量 nhumber+1 的 值 。 由 于 number 是 有 static 修 饰 的 ， 因 此 ， 每 一 次 调用 get_next 函 数 返 回 的 值 都 不 一 样 。Python 生 成 器 
的 功能 类 似 以 上 的 这 个 函数 。 下 面 介 绍 如 何 构造 一 个 生成 器 : 


方法 1 : 











def first generator(): 
yield "hello" 





方法 2 : 








def generator fib(n): 

first = 0 

second = 1 

for x in xrange(n): 

first,second = second, first+second 
yield first 




















以 上 的 代码 中 用 到 一 个 新 的 关键 字 : yield。 在 Python 中 使 用 了 yield 关 键 字 的 函数 一 定 是 一 个 生成 器 。yield 关 键 字 表示 返回 当前 的 值 ， 但 是 保存 当前 所 有 变量 及 其 内 存 状 态 ， 当 下 一 次 代码 被 调用 时 ， 
返回 原 有 的 内 存 状态 。 


方式 1 中 的 first generator 函 数 比较 简单 ， 每 次 调用 时 ， 都 只 是 返回 “hello” 字 符 串 。 但 是 ， 这 个 函数 和 def hello () : return “hello” 有 本 质 区 别 ， 例 如 : 


type(hello()) ====><type 'str'» 
type (first generator()) ====><type 'generator'> 














调用 hello 这 个 方法 之 后 ， 返 回 的 是 一 个 计算 之 后 的 值 ;而 调用 first_generator 之 后 ， 返 回 的 是 一 个 计算 表达 式 ， 真 正 获 取 它 的 值 需 要 调用 next 方 法 ， 或 者 在 for 循 环 中 直接 进行 迭代 。 
方式 2 中 的 generator _ fib 函数 返回 的 是 一 个 生成 器 ， 这 个 生成 器 的 作用 是 返回 0 ~ n 之 间 的 斐 波 那 契 数 列 。 


前 面 讲 了 如 何 构造 一 个 生成 器 ， 那 这 个 生成 器 怎么 使 用 ? 





result = first generator () 
for res in result: 
print res 











result = generator fib(10) 
for res in result: 
print res 
































result = first generator () 
result.next () 
result = generator fib(10) 
result.next () 





oor 


当 使 用 next 方 法 的 时 候 ， 执 行 到 生成 器 的 末尾 会 产生 StopItetation 异 常 。 


下 面 学 习 如 何 使 用 其 他 方式 创建 生成 器 。 我 们 把 前 面 所 学 的 列表 推导 : 








list test = [x for x in xrange(10)] 





修改 一 下 ， 就 成 为 了 生成 器 : 








list test = (x for x in xrange(10)) 





同样 地 ， 也 可 以 把 文件 对 象 改造 成 生成 器 : 


h 
L- 





le obj = open(file path,mode) 
le generator = (line for line in file obj) 























h 
Lie 











简单 的 生成 器 就 讲 到 这 里 ， 而 生成 器 的 作用 也 不 仅仅 是 实现 循环 这 么 简单 。 例 如 ， 可 以 使 用 生成 器 来 实现 cat filelgrep keyword 这 样 一 个 Linux 命 令 的 功能 ， 有 兴趣 的 可 自行 练习 一 下 相关 的 内 容 。 


总 结 : 使 用 生成 器 和 使 用 其 他 可 和 迭代 的 数据 类 型 非常 相似 ， 不 同 的 地 方 在 于 内 人 存 的 处 理 方式 。 生 成 器 的 执行 结果 并 没有 在 内 存 中 立即 展开 ， 而 是 在 执行 结果 被 调用 时 才 进 行 展开 ， 因 此 ， 从 内 存 消耗 角 
度 上 看 ， 生 成 器 更 加 节省 。 


为 此 ， 提 出 Python 性 能 优化 的 第 八条 原则 : 在 不 影响 可 读 性 的 原则 上 ， 建 议 使 用 生成 器 以 节省 内 存 ， 尤 其 是 在 处 理 需要 大 量 内 存 的 操作 时 。 


同时 需要 注意 的 是 () 的 用 法 ， 我 们 知道 tuple 也 是 使 用 () 定义 的 ， 并 且 ， 阅 数 和 方法 也 都 采用 了 (), 因此， () 到 底 表 示 的 是 什么 ， 需 要 根据 上 下 文 的 语 境 来 考虑 : 出 现在 def 关 键 字 同一 行 ， 表 
示 定 义 方法 或 者 函数 ;和 “， ”一 起 使 用 ， 表 示 构 造 tuple; 和 列表 推导 式 一 起 使 用 ， 表 示 构 造 生 成 器 。 


3.5.6 可 调用 的 变量 


变量 是 函数 的 例子 前 面 已 经 见 过 了 ， 如 map 函 数 ， 它 接收 的 第 一 个 参数 就 是 浮 数 。 有 了 这 一 个 概念 之 后 ， 现 在 看 一 下 什么 是 可 调用 的 变量 。 


可 调用 的 变量 即 可 以 被 解释 为 方法 或 者 函数 的 变量 ， 通 常 指 的 都 是 方法 或 者 函数 。 在 这 里 将 遇 到 一 个 新 的 内 置 函 数 : callable。 可 调用 的 变量 ,或 者 说 可 调用 的 对 象 ， 就 是 执行 callable (param) 之 后 
返回 为 True 的 变量 ， 简 单 地 说 ， 就 是 能 够 直接 在 最 后 边 添加 () 的 变量 或 者 对 象 。 例 如 : 


def hello():pass result = hello 





在 上 面 的 代码 中 ， 执 行 callable (result) 将 得 到 True， 即 result () 的 形式 是 可 行 的 ， 这 种 变量 就 称 为 可 调用 的 对 象 或 者 变量 ; 其 余 的 便 称 为 不 可 调用 的 变量 或 者 对 象 。 在 这 里 再 次 强调 一 下 ，Python 
中 ， 一 切 均 可 以 是 变量 ， 包 括 函 数 和 方法 。 下 面 来 看 这 么 一 段 代 码 : 











def callback fun(function,name,age): 
true name = function (name) 
return "The user name is $s,age is $d" $ (true name,age) 
def get true name (name): 
return "".join([" " name]) 
print callback fun(get true name, "awcloud", 24) 


























这 一 段 代码 是 完全 合法 而 且 正 确 的 ， 在 这 段 代码 中 ， 将 get_true_name 当 作 一 个 普通 的 变量 传递 到 callback_fun 当 中 ， 在 该 方法 中 执行 然后 返回 相应 的 结果 。 
回 过 头 来 看 一 下 以 前 说 过 的 采用 字典 方式 实现 switch 语 法 。 


def hello(): 
return "Hello" 











def greeting(): 
return "Hello,awcloud" 








def say goodbye (): 


return "Goodbye,awcloud" 














OPERATION = ("hello":hello, 
"greeting":greeting, 
"say goodbye":say goodbye] 




















def switch function (operation, *arg, **karg): 
return OPERATION [operation] (*arg, **karg) 




















以 上 代码 中 构造 了 一 个 字典 OPERATION ， 这 个 字典 的 键 是 操作 条 件 ， 值 是 对 应 的 操作 ; 还 定义 了 一 个 方法 switch_function ， 根 据 传递 过 来 的 参数 ， 选 择 不 同 的 函数 ， 实 现 不 同 的 功能 。 这 个 例子 是 简 


易 的 switch 语 法 的 模拟 。 


3.5.7 ”变量 作用 域 
在 讲解 变量 的 时 候 ， 提 到 了 两 个 概念 : 全 局 变量 和 局 部 变量 ， 下 面 介绍 这 两 种 变量 之 间 的 区 别 。 先 看 下 面 的 代码 


operation = ["add","sub"] 

def get operation(): 
operation = {"lucifer":10000} 
return operation 

















暂时 忽略 这 段 代 码 的 命名 是 否 规范 ， 先 看 一 下 这 段 代 码 的 返回 值 ， 返 回 的 是 字典 形式 的 operation 还 是 列表 形式 的 operation? 为 了 回答 这 个 问题 ， 先 讲解 一 下 Python 的 变量 搜索 顺序 。 在 Python 中 搜 
索 变 量 时 ， 总 是 local>file>global， 即 优先 搜索 局 部 变量 ， 其 次 是 在 本 文件 中 定义 的 全 局 变量 ， 最 后 才 是 整个 工程 中 的 全 局 变量 。 如 果 这 三 种 变量 同时 出 现 ， 默 认 优先 使 用 局 部 变量 ， 当 查找 不 到 局 部 变量 
时 ， 再 依次 查找 文件 中 的 全 局 变量 和 工程 中 的 全 局 变量 。 值 得 注意 的 是 ， 由 于 可 读 性 和 可 维护 性 ， 一 般 来 说， 在 代码 中 禁止 使 用 工程 级 别 的 全 局 变量 。 所 以 ， 上 边 一 段 代码 返回 的 将 是 字典 形式 的 
operation。 那 么 ， 如 果 想 得 到 列表 形式 的 operation， 该 怎么 做 ? 


operation = ["add","sub"] 

def get operation(): 
operation = {"lucifer":10000} 
global operation 
return operation 




















operation = ["add","sub"] 
def get operation(): 
return operation 














添加 上 面 加 粗 部 分 的 代码 ， 或 者 如 同 第 二 段 代 码 一 样 ， 就 能 得 到 列表 形式 的 operation。 


下 面 来 介绍 一 下 关键 字 global。global 一 般 用 于 表明 该 变量 是 全 局 变量 。 搜 索 用 global 修 饰 的 变量 时 ， 应 该 在 全 局 变量 中 查找 。 上 边 的 代码 中 使 用 global， 表 示 在 该 条 语句 之 后 ， 使 用 的 operation 变 量 
均 是 全 局 变量 。global 关 键 字 的 存在 ， 导 致 很 多 代码 的 可 读 性 和 可 维护 性 下 降 ， 同 时 ， 搜 索 全 局 变量 比 搜索 局 部 变量 要 慢 ， 导 致 全 局 变量 在 一 定 程度 上 将 影响 程序 的 性 能 。 


在 此 ， 提 出 Python 性 能 优化 的 第 九条 原则 : 除了 实现 switch 语 法 和 日 志 记录 之 外 ， 在 没有 必要 的 情况 下 ， 茶 止 使 用 全 局 变量 。 


i: 


1) ME ARS, SERUILAZZ3HIETBSSEREHNTTS TAA NRSSER, 
2) 从 执行 的 角度 看 ， 变 量 可 以 分 为 可 调用 的 变量 和 不 可 调用 的 变量 。 


3) 从 作用 域 和 搜索 顺序 的 角度 看 ， 变 量 可 以 分 为 局 部 变量 和 全 局 变量 。 


36 EVE 


本 章 主要 讲述 了 Python 的 基础 语法 、Python 语 言 的 一 些 特 性 和 相关 操作 ， 还 总 结 了 Python 的 9 条 优化 原则 ， 这 些 是 一 线 工 程 师 多 年 开发 经 验 的 结晶 。 


第 4 章 ”Python 模块 


本 章 主要 讲解 OpenStack 中 用 到 的 一 些 主要 Python 模块 ， 包 括 SQLAlchemy、logging、Eventlet、WSGI、Paste Deploy, 


4.1 SQLAIchemy 


SQLAIchemy 是 Python 操作 数据 库 的 一 个 库 ， 能 够 进行 ORM 了 映射 。 


SQLAIchemy 采 用 简单 的 Python 语言 ， 为 高 效 和 高 性 能 的 数据 库 访 问 设计 实现 了 完整 的 企业 级 持久 模型 。SQLAIchemy 的 理念 是 ，SQL 数 据 库 的 量 级 和 性 能 重要 于 对 象 集 合 ， 而 对 象 集合 的 抽象 又 重要 
于 表 和 行 。 


4.1.1 安装 SQLAIchemy 


安装 SQLAIchemy 模 块 : 





pip install sqlalchemy 
导入 时 如 果 没 有 报错 则 表明 安装 成 功 : 


>>> import sqlalchemy 

>>> sqlalchemy. version _ 
"091" 

>>> 


4.1.2 ”使 用 SQLAIchemy 对 数据 库 操作 


下 面 的 数据 库 使 用 SQLite。 


1. 定 义 元 信息 ， 绑 定 到 引擎 








>>>from sqlalchemy import * 

>>>from sqlalchemy.orm import * 

>>>engine = create engine('sqlite:///./sqlalchemy.db', echo-True) # 定义 引擎 
>>> metadata = MetaData (engine) 4 绑 定 元 信息 

>>> 




















2. 创 建 表格 ， 初 始 化 数据 库 





>>> users table = Table('users', metadata, 










































































http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... Column('id', Integer, primary key=True), 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... Column('name', String(40)), 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... Column('email', String(120))) 

>>> 


>>> users table.create () 
2014-01-09 10:03:32,436 INFO sqlalchemy.engine.base.Engine 
CREATE TABLE users ( 
id INTEGER NOT NULL, 
name VARCHAR (40), 
email VARCHAR (120), 
PRIMARY KEY (id) 








































































































2014-01-09 10:03:32,436 INFO sqlalchemy.engine.base.Engine () 
2014-01-09 10:03:32,575 INFO sqlalchemy.engine.base.Engine COMMIT 
>>> 


执行 上 述 代 码 ， 即 可 创建 一 个 users 表 ， 表 中 有 id、name、email 三 个 字段 。 





(env) ghost @ghost-H61M-S2V-B3:~/project/flask/fsql$ sqlite3 sqlalchemy.db 
SOLite version 3.7.13 2012-06-11 02:05:22 

Enter ".help" for instructions 

Enter SQL statements terminated with a ";" 
sqlite» .tables 

users 
sqlite» 


















































3. 基 本 操作 一 一 插入 


如 果 表 已 经 存在 ， 第 二 次 运行 就 不 需要 创建 了 ， 使 用 autoload 设 置 。 





>>>from sqlalchemy import * 

>>>from sqlalchemy.orm import * 

>>>engine = create engine('sqlite:///./sqlalchemy.db', echo-True) 
>>>metadata = MetaData (engine) 






















































































>>> users table = Table('users', metadata, autoload=True) 

2014-01-09 10:20:01,580 INFO sqlalchemy.engine.base.Engine PRAGMA table info ("users") 
2014-01-09 10:20:01,581 INFO sqlalchemy.engine.base.Engine () 

2014-01-09 10:20:01,582 INFO sqlalchemy.engine.base.Engine PRAGMA foreign key list ("users") 
2014-01-09 10:20:01,583 INFO sqlalchemy.engine.base.Engine () 

2014-01-09 10:20:01,583 INFO sqlalchemy.engine.base.Engine PRAGMA index list ("users") 
2014-01-09 10:20:01,583 INFO sqlalchemy.engine.base.Engine () 






































>>> users table 
Table('users', MetaData (bind-Engine (sqlite:///./sqlalchemy.db)), Column('id', INTEGER(), table=<users>, primary key-True, nullable-False), Column('name', VARCHAR(length-40), te 
































>>> 





实例 化 一 个 插入 句柄 : 





>> i = users table.insert () 

>>>i 

<sqlalchemy.sql.dml.Insert object at 0x31bc850» 

>>> print i 

NSERT INTO users (id, name, email) VALUES (?, ?, ?) 

>>>i.execute (name='rsj217', email='rsj21@gmail.com') 

2014-01-09 10:24:02,250 INFO sqlalchemy.engine.base.Engine INSERT INTO users (name, email) VALUES (?, ?) 
2014-01-09 10:24:02,250 INFO sqlalchemy.engine.base.Engine ('rsj217', 'rsj21@gmail.com') 

2014-01-09 10:24:02,251 INFO sqlalchemy.engine.base.Engine COMMIT 
<sqlalchemy.engine.result.ResultProxy object at 0x31bce10» 
»»»i.execute(('name': 'ghost'},{'name': 'test'}) 
2014-01-09 10:24:57,537 INFO sqlalchemy.engine.base.Engine INSERT INTO users (name) VALUES (?) 
2014-01-09 10:24:57,537 INFO sqlalchemy.engine.base.Engine (('ghost',), ('test',)) 

2014-01-09 10:24:57,537 INFO sqlalchemy.engine.base.Engine COMMIT 
<sqlalchemy.engine.result.ResultProxy object at 0x31bcd50» 

>>> 



























































































































































数据 库 内 容 如 下 : 





sqlite> select * from users; 
1|rsj217|rsj218gmail.com 
2|ghost | 

3|test| 

sqlite» 





查询 、 删 除 操作 和 插入 的 用 法 类 似 ， 都 需要 先 实 例 一 个 sqlalchemy.sql.dm| 对 象 。 


4.1.3 使 用 ORM 


使 用 ORM 就 是 将 Python 的 类 与 数据 库 的 表 映 射 ， 而 不 用 直接 写 SQL 语 句 。 


创建 映射 : 


>>>class User (object): 












































































































































http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/17414/0EBPS/Text/... def repr (self): 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/17414/0EBPS/Text/... return '$s($r, $r)' $ (self. class . name , self.name, self.eme 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 

>>> mapper (User, users table) # 创建 映射 E 

«Mapper at Ox3lbcfd0; User» 

>>>ul = User () 

>>> ul.name 

>>> print ul 

User (None, None) 

>>> print ul.name 

None 

>>> 

建立 会 话 ， 这 里 以 查询 、 插 入 为 例 进行 简单 介绍 。 

查询 : 

>>>session = create session() 

>>>session 

<sqlalchemy.orm.session.Session object at Ox3lbef10> 

>>>query = session.query (User) 

>>>query 

<sqlalchemy.orm.query.Query object at 0x31bee50> 

>>> u = query.filter by(name='rsj217') .first () 

2014-01-09 10:44:23,809 INFO sqlalchemy.engine.base.Engine SELECT users.id AS users id, users.name AS users name, users.email AS users email 
FROM users 








WHERE users.name = ? 

LIMIT ?OFFSET ? 

2014-01-09 10:44:23,809 INFO sqlalchemy.engine.base.Engine ('rsj217', 1, 0) 
>>> u.name 

u'rsj217' 

>>> 



































插入 : 











>>>from sqlalchemy import * 

>>>from sqlalchemy.orm import * 

>>>engine = create engine('sqlite:///./sqlalchemy.db') 
>>>metadata = MetaData (engine) 

>>> users table = Table('users', metadata, autoload=True) 
>>>class User(object): pass 

http://www. hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
>>>mapper (User, users table) 

<Mapper at 0x18185d0; User> 

>>> Session = sessionmaker (bind=engine) 

>>>session = Session () 

>>> u = User () 

>>> u.name = 'new' 

>>>session.add(u) 

>>>session. flush () 

>>>session.commit () 
































I 




















>>> 





建立 会 话 时 ， 采 用 sessionmaker 的 方式 更 好 一 些 。 关 于 删除 、 创 建 关系 、 事 务 等 高 级 操作 ， 这 里 不 再 详细 介绍 ， 感 兴趣 的 读者 可 自行 参考 官方 文档 。 


4.1.4 完整 示例 


下 面 看 一 个 SQLAIchemy 的 完整 示例 ， 该 示例 使 用 MYSQL 数 据 库 ， 具 体 如 下 : 


from sqlalchemy import * 
from sqlalchemy.orm import sessionmaker, mapper 
from obj.dbobj import User 

















def init db(): 


engine = create engine ("mysql://root:sqlPwd@localhost/chat") 
metadata = MetaData () 











table = Table('users', metadata, 

Column('user id', String(20), primary key=True), 

Column('user pwd', String(20))) 
metadata.create all (engine) 








mapper (User, table) 


Session = sessionmaker (engine) 
return Session () 


class database: 











def init (self, session): 
self.session = session 
self.query = self.session.query (User) 

















def getUser(self, user id): 


return self.query.get (user id) 























def getPwd(self, user id): 
user = self.getUser(user id) 
return user.pwd () 

















def insertInfo(self, user id, pwd): 
user = User(user id, pwd) 
self.session.add (user) 
self.session.commit () 























def deleteInfo(self, user id): 
user = self.getUser (user id) 
self.session.delete (user) 
self.session.commit () 


























def getCount (self): 
return self.query.count () 

















def getAllUser (self): 
return self.query.all () 























def modifyPwd(self, user id, pwd): 
self.query.filter(User.user id == user id).update(("user pwd" : pwd}) 
self.session.commit () 























def getDB(): 

engine = init db() 

db = database (engine) 
return db 











4.2 logging 模块 


Python 的 logging 模 块 提供 了 通用 的 日 志 系 统 ， 可 以 方便 第 三 方 模块 或 者 应 用 使 用 。 这 个 模块 提供 不 同 的 日 志 级 别 ， 并 可 以 采用 不 同 的 方式 记录 日 志 ， 如 文件 、 HTTP、SMTP、Socket 等 ， 甚 至 可 以 自 
己 实 现 具体 的 日 志 记录 方式 。 


4.2.1 logging 的 使 用 


logging 的 简单 使 用 如 下 : 


#!/usr/local/bin/python 
# -*- coding:utf-8 -*- 
import logging 








logging.debug('debug message!) 
logging.info('info message") 
logging.warn('warn message') 
logging.error('error message') 
logging.critical('critical message') 





























输出 结果 : 








WARNING:root:warn message 


ERROR:root:error message 
CRITICAL:root:critical message 


























默认 情况 下 ，logging 模 块 将 日 志 输 出 到 屏幕 上 (stdout) ， 日 志 级 别 为 WARNING ( 即 只 有 日 志 级 别 高 于 WARNING 的 日 志 信息 才 会 输出 ) 。 日 志 格 式 如 图 4-1 所 示 。 


WARNING : root : Warn message 
日 志 级 别 Logger 实 例 名 称 : 日志 消息 内 容 


图 4-1 日志 格 式 
下 面 介绍 日 志 级 别 等 级 及 其 设置 方式 ， 如 怎样 设置 日 志 的 输出 方式 。 


1. 日 志 级 别 


常用 的 日 志 级 别 如 表 4-1 所 示 。 


表 4-1 日 志 级 别 


级 别 何 时 使 用 
DEBUG 详细 信息 ， 典 型 地 调试 问题 时 会 感 兴趣 
INFO 证 明 事 情 按 预期 工作 
WARNING | 表明 发 生 了 一 些 意 外 ， 或 者 不 久 的 将 来 会 发 生 问 题 (如 “磁盘 满 了 ”)， 但 目前 软件 还 是 在 正常 工作 
ERROR 由 于 更 严重 的 问题 ， 软 件 已 不 能 执行 一 些 功能 了 
CRITICAL | 严重 钳 误 ， 表 明 软 件 已 不 能 继续 运行 了 


2. 简 单 配 置 


#!/usr/local/bin/python 
# =*= coding:utf-8 -*- 
import logging 


# 通过 下 面 的 方式 简单 配置 输出 方式 与 日 志 级 别 
logging.basicConfig (filename='logger.log', level=logging. INFO) 


























logging.debug('debug message!) 
logging.info('info message') 
logging.warn('warn message') 
logging.error('error message') 
logging.critical('critical message') 
































程序 执行 后 的 标准 输出 (屏幕 ) 未 显示 任何 信息 ， 发 现 当前 工作 目录 下 生成 了 logger.log， 内 容 如 下 : 





INFO: root:info message 
WARNING: root:warn message 
ERROR: root :error message 
CRITICAL:root:critical message 






































因为 通过 level=logging.INFO 设 置 日 志 级 别 为 INFO， 所 以 会 输出 所 有 日 志 信息 。 


4.2.2 耕 干 重要 的 概念 


下 面 先 了 解 几 个 比较 重要 的 概念 : Logger、Handler、Filter、Formatter， 如 表 4-2 所 示 。 


表 4-2 ”概念 及 解释 


名 称 内 容 
Logger (记录 大 ) 其 露 应 用 程序 代码 能 直接 使 用 的 接口 
Handler (处 理 需 ) Tí Goa ÆR) 日 ae E E 目的 地 
Filter (YE $5 ) 提供 更 好 的 粒度 控制 ， 可 以 决定 输出 哪些 日 志 记 录 
Formatter (格式 化 硕 ) 指明 最 终 输出 中 日 志 记 录 的 布局 





1.Logger 


Logger 是 一 个 树 形 层级 结构 ， 在 使 用 接口 debug、info、warn、error、critical 之 前 必须 创建 Logger 实 例 ， 即 创建 一 个 记录 器 ， 如 果 没 有 显 式 地 进行 创建 ， 则 默认 创建 一 个 root logger， 并 应 用 默认 
的 日 志 级 别 (WARN) 、 处 理 器 Handler (StreamHandler， 即 将 日 志 信 息 输出 在 标准 输出 设备 上 ) 和 格式 化 器 Formatter (默认 的 格式 即 为 第 一 个 简单 使 用 程序 中 输出 的 格式 ) 。 


创建 方法 : 











logger = logging.getLogger (logger name) 





创建 Logger 实 例 后 ， 可 以 使 用 以 下 方法 进行 日 志 级 别 设 置 ， 增 加 处 理 器 Handler。 

: logger.setLevel (logging ERROR) : 设置 日 志 级 别 为 ERROR， 即 只 有 日 志 级 别 大 于 等 于 ERROR 的 日 志 才 会 输出 。 
: logger.addHandler (handler name) : 为 Logeetr 实 例 增 加 一 个 处 理 器 。 

- logger.removeHandler (handler name) : 为 Logset 实 例 删除 一 个 处 理 器 。 


需要 强调 的 是 ，Logger 是 一 个 树 形 层级 结构 ， 如 图 4-2 所 示 。 


Filter 


Formatter 





图 4-2 ”Logger 树 形 层 级 结构 


Logger 可 以 包含 一 个 或 多 个 Handler 和 Filter， 即 Logger 与 Handler 或 Fitler 是 一 对 多 的 关系 ; 一 个 Logger 实 例 可 以 新 增多 个 Handler， 一 个 Handler 可 以 新 增多 个 Formatter 或 多 个 Filter， 而 且 日 志 级 
别 将 会 继承 。 


2.Handler 

Handler 处 理 器 有 很 多 种 类 型 ， 比 较 常 用 的 有 三 个 ， 即 StreamHandler、FileHandler、NullHandler， 详 情 可 以 访问 Python logging.handlers, 
创建 streamHandler 之 后 ， 可 以 通过 以 下 方法 设置 日 志 级 别 ， 设 置 格式 化 器 Formatter， 增 加 或 删除 过 滤器 Filter。 

: ch.setLevel (logging WARN) : 指定 日 志 级 别 ， 低 于 WARN 级 别 的 日 志 将 被 忽略 。 

- ch.setFormatter (formatter name) : 设置 一 个 格式 化 器 formatter。 

ch.addFilter (filter_name) : 增加 一 个 过 滤器 ， 可 以 增加 多 个 。 


: ch.removeFilter (filter name) : 删除 


e 
| 
> 
位 
ak 
$8 


StreamHandler 创 建 方法 : 


sh = logging.StreamHandler (stream=None) 








FileHandler 创 建 方法 : 














fh = logging.FileHandler(filename, mode='a', encoding-None, delay-False) 





NullHandler 类 位 于 核心 logging 包 ， 不 做 任何 的 格式 化 或 者 输出 。 本 质 上 它 是 一 个 “什么 都 不 做 ”的 handler， 由 库 开 发 者 使 用 。 


3.Filter 


Handler 和 Logger 可 以 使 用 Fitter 来 完成 比 级 别 更 复杂 的 过 滤 。Filter 基 类 只 允许 特定 Logger 层 次 以 下 的 事件 。 例 如 ， 用 'A.B 初始 化 的 Filter 允 许 LoggerA.B'、'A.B.C、'A.B.C.D、'A.B.D 等 记录 的 事 
件 ，loggerA.BB'`、'B.A.B 等 就 不 行 。 如 果 用 空 字符 串 来 初始 化 ， 所 有 的 事件 都 接受 。 


创建 方法 : 





filter = logging.Filter (name-'') 








4.Formatter 
使 用 Formatter 对 象 可 以 设置 日 志 信 息 最 后 的 规则 、 结 构 和 内 容 ， 默 认 的 时 间 格 式 为 9Y-%m-%d9%H: WM: 96S, 


创建 方法 : 














formatter = logging.Formatter (fmt=None, datefmt=None) 








其 中 ，fmt 是 消息 的 格式 化 字符 串 ，datefmt 是 日 期 字符 串 。 如 果 不 指明 fmt， 将 使 用 '% (message) s'。 如 果 不 指明 datefmt， 将 使 用 |SO8601 日 期 格式 。 


4.2.3 logging 工 作 流 程 


1.logging 模 块 使 用 过 程 
1) 第 一 次 导入 logging 模 块 或 使 用 reload 函 数 重新 导入 logging 模 块 ，logging 模 块 中 的 代码 将 被 执行 ， 这 个 过 程 中 将 产生 logging 日 志 系统 的 默认 配置 。 


2) 自 定义 配置 (可 选 ) 。logging 标 准 模块 支持 三 种 配置 方式 : dictConfig、fileConfig、listen。 其 中 ，dictConfig 通 过 一 个 字典 配置 Logger、Handler、Filter、Formatter; fileConfig 通 过 一 个 文 
件 进行 配置 ; listen 则 监听 一 个 网 络 端口 ， 通 过 接收 网 络 数据 来 进行 配置 。 除 了 以 上 集体 化 配置 外 ， 也 可 以 直接 调用 Logger、Handler 等 对 象 中 的 方法 在 代码 中 来 显 式 配置 。 


3) 使 用 logging 模 块 的 全 局 作用 域 中 的 getLogger 国 数 来 得 到 一 个 Logger 对 象 实例 〈 其 参数 是 一 个 字符 串 ， 表 示 Logger 对 象 实例 的 名 字 ， 即 通过 该 名 字 来 得 到 相应 的 Logger 对 象 实例 ) 。 
4) 使 用 Logger 对 象 中 的 debug、info、error、warn、critical 等 方法 记录 日 志 信 息 。 

2.logging 模 块 处 理 流程 

1) 判断 日 志 的 等 级 是 否 大 于 Logger 对 象 的 等 级 ， 如 果 大 于 ， 则 往 下 执行 ， 否 则 ， 流 程 结 束 。 

2) 产生 日 志 。 第 一 步 ， 判 断 是 否 有 异常 ， 如 果 有 ， 则 添加 异常 信息 。 第 二 步 ， 处 理 日 志 记录 方法 (如 debug、info 等 ) 中 的 占 位 符 ， 即 一 般 的 字符 串 格式 化 处 理 。 


3) 使 用 注册 到 Logger 对 象 中 的 Filters 进 行 过 滤 。 如 果 有 多 个 过 滤器 ， 则 依次 过 滤 ; 只 要 有 一 个 过 滤器 返回 假 ， 则 过 渡 结 束 ， 且 该 日 志 信 息 将 丢弃 ， 不 再 处 理 ， 而 处 理 流程 也 至 此 结束 。 否 则 ， 人 处 理 流 
程 往 下 执行 。 


A) 在 当前 Logger 对 象 中 查找 Handler， 如 果 找 不 到 任何 Handler， 则 往 上 到 该 Logger 对 象 的 父 Logger 中 查找 ; 如 果 找 到 一 个 或 多 个 Handler， 则 依次 用 Handler 来 处 理 日 志 信息 。 但 在 每 个 Handler 处 
理 日 志 信 息 过 程 中 ， 会 首先 判断 日 志 信息 的 等 级 是 否 大 于 该 Handler 的 等 级 ， 如 果 大 于 ， 则 往 下 执行 (由 Logger 对 象 进 入 Handler 对 象 中 ) ， 否则， 处 理 流程 结束 。 


5) 执行 Handler 对 和 象 中 的 filter 方 法 ， 该 方法 会 依次 执行 注册 到 该 Handler 对 象 中 的 Filter。 如 果 有 一 个 Filter 判 断 该 日 志 信息 为 假 ， 则 此 后 的 所 有 Filter 都 不 再 执行 ， 而 直接 将 该 日 志 信 息 丢 奔 ， 处 理 流程 
结束 。 


6) 使 用 Formatter 类 格式 化 最 终 的 输出 结果 。 注 : Formatter 同 “产生 日 志 ” 第 二 步 的 字符 串 格式 化 不 同 ， 它 会 添加 额外 的 信息 ， 如 日 志 产生 的 时 间 、 产 生日 志 的 源 代码 所 在 的 源 文件 的 路 径 等 。 


7) 真正 地 输出 日 志 信息 (到 了 网络、 文件、 终端 、 邮 件 等 ) 。 至 于 输出 到 哪个 目的 地 ， 由 Handler 的 种 类 来 决定 。 


424 Beate 


1. 配 置 方 式 
显 式 创建 记录 器 Logger、 人 处理 器 Handler 和 格式 化 器 Formatter， 并 进行 相关 设置 。 
. 通过 简单 方式 进行 配置 ， 使 用 basicConfig () 函数 直接 进行 配置 。 
. 通过 配置 文件 进行 配置 ， 使 用 fleConfig O 函数 读 取 配 置 文件 。 
. 通过 配置 字典 进行 配置 ， 使 用 dictConfig () 函数 读 取 配 置信 息 。 
. 通过 网 络 进行 配置 ， 使 用 listen () 函数 进行 网 络 配置 。 
basicConfig 关 键 字 参数 如 表 4-3 所 示 。 
表 4-3 basicConfig 关 键 字 
KEF 描述 
filename 创建 一 个 FileHandler， 使 用 指定 的 文件 名 ， 而 不 使 用 StreamHandler 
filemode 如 果 指 明了 文件 名 ， 指 明 打 开 文 件 的 模式 (如 果 没 有 指明 filemode， 默 认为 'a') 


format Handler 使 用 指明 的 格式 化 字符 串 

datefmt 使 用 指明 的 日 期 / 时 间 格 式 

level 指明 根 Logger 的 级 别 

stream 使 用 指明 的 流 来 初始 化 StreamHandler。 该 参数 与 'filename' PRR, "WIRT P. 'stream' 被 忽略 


常用 的 format 格 式 如 表 4-4 所 示 。 


表 4-4 format X, 
格式 描述 
%(levelno)s au thy A EA BN AY BL 
%(levelname)s i HH 日志 级 别名 称 
%(pathname)s aii 当前 执 TEE — 





%(filename)s 输出 当前 执行 程序 
%(funcName)s Ai cH H a AY 4 eI s 
%(lineno)d mid AAKI 
%(asctime)s Fag HH, a AY YT] 
%(thread)d 前 出 线程 ID 
%(threadName)s ay tt} ZR FEMA BK 
%(process)d 输出 进程 ID 
%(message)s ath 日志 信息 

HK#time.strftime: https: //docs.python.org/2/library /time.html?highli ght=steftime##time.strftime. 

2. 配 置 示例 

(1) 显 式 配置 


使 用 程序 logger.py 如 下 : 








# -*- encoding:utf-8 -*- 
import logging 


# create logger 

logger name = "example" 

logger = logging. getLogger (logger_name) 
logger.setLevel (Logging. DEBUG) 























# create file handler 

log path = "./log.log" 

fh = logging.FileHandler (log path) 
fh.setLevel (logging.WARN) 


























# create formatter 






































fmt = 

"$ (asctime)-15s dob ex $(filename)s $(lineno)d $(process)d % (message) s" 
datefmt = "$a $d $b $ :$M:$S" 

formatter = logging. ce datefmt) 








# add handler and formatter to logger 
fh.setFormatter (formatter) 
logger.addHandler (fh) 





























# print log info 
logger. debug (' debug message !) 
logger.info('info message') 
logger.warn('warn message') 
logger.error('error message!) 
logger.critical('critical message') 


























(2) 文件 配置 


配置 文件 logging.conf 如 下 : 


keys-root,example01 





[logger root] 
level-DEBUG 
handlers=hand01,hand02 








[logger example01] 
handlers-handa01,hand02 
qualname-exampleO1 
propagate=0 








[handlers] 
keys=hand01,hand02 





[handler hand01] 
class=StreamHandler 
level=INFO 
Formatter=form02 
args=(sys.stderr, ) 

















[handler hand02] 
class-FileHandler 
level-DEBUG 
Formatter-form01 
args-('log.log', 'a') 


























[formatters] 
keys-form01,form02 




















[formatter form01] 
format-$ (asctime)s $(filename)s[line:$(lineno)d] %(levelname)s $(message)s 























使 用 程序 logger.py 如 下 : 





# -*- encoding:utf-8 -*- 
import logging 
import logging.config 


























logging.config.fileConfig("./logging.conf") 





f create Dai 
logger name = "example" 








logger 


logger. 
logger. 


logging.getLogger (logger name) 








debug ('debug message") 
info('info message') 











logger. 


warn ('warn message') 





logger. 


error ('error message!) 








logger. 


critical ('critical message") 





(3) 字典 配置 


可 以 使 用 logging.config.dictConfig (config) 编写 一 个 示例 程序 发 给 作者 ， 以 完善 本 文 。 


(4) 监听 配置 


可 以 使 用 logging.config.listen (port=DEFAULT LOGGING CONFIG PORT) 编写 一 个 示例 程序 发 给 作者 ， 以 完善 本 文 。 


4.3 Eventlet 


Eventlet 库 在 OpenStack 服 务 中 的 上 镜 率 很 高 ， 尤 其 是 在 服务 的 多 线程 和 WSGI Server 并 发 处 理 请 求 的 情况 下 ， 深 入 了 解 Eventlet 库 是 很 必要 的 。Eventlet 库 是 由 second life 开 源 的 高 性 能 网 络 库 ， 从 
Eventlet 的 源码 可 以 知道 ， 其 主要 依赖 于 两 个 关键 的 库 : 


: greenlet: greenlet 库 过 程 化 了 其 并 发 的 基础 ，Eventlet 库 对 其 进行 简单 封装 之 后 ， 


- select.epoll (或 者 epoll 等 类 似 的 库 ) 


正 由 于 这 两 个 库 的 相对 独立 性 ， 可 以 从 两 个 方面 来 学 习 Eventlet 库 。 


43.1 g 


reenlet 


greenlet 称 为 协 程 (coroutine) ， 具 有 以 下 特点 : 


. 每 个 协 程 都 有 自己 的 私有 stack 及 局 部 变量 。 


- 同一 时 间 内 只 有 一 个 协 程 在 运行 ， 


故 无 须 对 某 些 共享 变量 加 锁 。 


: 协 程 之 间 的 执行 顺序 完成 由 程序 来 控制 。 


总 之 ， 协 程 是 运行 在 一 个 线程 内 的 伪 并 发 方式 ， 最 终 只 有 一 个 协 程 在 


import greenlet 











Les 














t2 (n): 











W tes 
Ltch 


t2:" 


2 n 
(23) 








A tes 


t2: over" 





greenle 





current 


t = greenlet.greenlet 








= greenlet ( 


= greenlet.getcurrent () 
testl, current) 








gr] 





gr2 = greenlet ( 




















test2, current) 








grl.switch (2) 




















\ 一 /一 


1517, 


: select 库 中 的 epoll 是 其 默认 的 网 络 通信 模型 。 


就 构成 了 GreenTread。 


然后 由 程序 来 控制 其 执行 的 顺序 。 以 上 内 容 可 以 通过 下 面 的 例子 来 理解 。 


整个 程序 首先 创建 两 个 协 程 ， 创 建 的 过 程 传 入 了 要 执行 的 函数 和 父 greenlet 然 后 调用 其 中 一 个 协 程 的 Switch 函数 ， 并 且 传 递 参数 ， 就 开始 执行 test1， 然 后 到 了 gr2.switch (32) 语句 ， 切 换 到 test2 函 
数 ， 最 后 又 切换 回去 。 最 终 test1 运 行 结束 ， 回 到 父 greenlet 中 ， 执 行 结束 。 在 这 个 过 程 中 始终 只 有 一 个 协 程 在 运行 ， 函 数 的 执行 流 由 程序 自己 来 控制 。 


43.2 G 


reenThread 


在 Eventlet 中 对 greenlet 进 行 了 简单 的 封装 ， 就 成 了 GreenThread， 并 且 还 会 引 来 一 个 问题 : 如 果 我 们 想 要 写 一 个 协 程 ， 那 到 底 该 如 何 来 控制 函数 的 执行 过 程 ， 如 果 协 程 多 了 ， 控 制 则 不 是 很 复杂 了 ? 
带 着 这 个 问题 来 看 Eventlet 的 实现 。 


先 通过 Eventlet 的 官方 文档 来 了 解 该 如 何 使 用 Eventlet 库 。 我 们 从 其 中 选 出 一 个 接口 来 分 析 一 一 spawn 冰 数 ， 调 用 该 函数 ， 将 会 使 用 一 个 GreenThread 来 执行 用 户 传 入 的 函数 。 函 数 具 体 接口 如 下 : 





f spawn(func, 





*args, **kwargs): 


参数 很 清晰 ， 即 想 要 执行 的 函数 以 及 函数 的 参数 。 该 函数 实际 上 只 做 了 三 件 事 ， 最 后 返回 创建 的 greenthread， 因 此 该 函数 相 比 于 spawn_n 可 以 得 到 函数 调用 的 结果 。 


hub = hubs.get hub() 

g — GreenThread (hub.greenlet) 

hub.schedule call global (0,g.switch, func, args, kwargs) 
return g 








第 一 ， 要 知道 hub 的 作用 ， 这 在 Eventlet 的 官方 文档 有 相关 介绍 。greenlet 的 官方 文档 开始 就 介绍 


到 我 们 可 以 自己 构造 greenlet 的 调度 器 ， 那 么 hub 的 第 一 个 作用 就 是 greenthread 的 调度 器 ; 另外 一 个 


作用 与 网 络 相关 ， 所 以 hub 有 多 个 实现 ， 对 应 于 epoll、select、poll、pyevent 等 ， 我 们 先 看 第 一 个 作用 。 


hub 在 Eventlet 中 是 一 个 单 态 实例 ， 即 全 局 只 有 这 一 个 实例 ， 其 包含 一 个 greenlet 实 例 ， 该 greenlet 实 例 是 self.greenlet=greenlet (self.run) ， 这 个 实例 就 是 官方 文档 提 到 的 MAINLOOP (EA 
X) ， 具 体 就 是 指 其 中 的 run 方 法 ， 是 一 个 主 循环 。 该 hub 还 有 两 个 重要 的 列表 变量 ， 即 self.timers 和 self.next timers， 前 者 是 一 个 列表 ， 但 是 在 这 个 列表 上 实现 了 一 个 最 小 堆 ， 用 来 存储 将 被 调度 运行 的 
greenthread， 后 者 用 来 存储 新 加 入 的 greenthread。 


第 二 ， 创 建 一 个 GreenThread 的 实例 ，greenthread 继 承 于 greenlet， 简 单 封装 了 下 ， 该 类 的 构造 函数 只 需要 一 个 参数 ， 即 父 greenlet， 然 后 在 自己 的 构造 函数 中 调用 父 类 greenlet 的 构造 函数 ， 传 递 
两 个 参数 ， 即 GreenTread 的 main 函 数 和 一 个 greenlet 的 实例 。 由 第 二 段 代 码 知道 ，hubs 中 作为 MAINLOOP 的 greenlet 是 所 有 先 创建 的 greenthread 的 父 greenlet。 由 前 面 介绍 greenlet 的 例子 中 ， 我 们 可 
以 知道 ， 当 调用 该 greenthread 的 switch 方 法 时 ， 将 会 开始 执行 传递 给 父 类 的 self.main 遂 数 。 


第 三 ， 单 态 的 hub 调 用 schedule_call_global 函 数 ， 该 函数 的 作用 可 以 看 其 注释 ， 用 来 调度 函数 去 执行 。 


Schedule a callabl to be called after 'seconds' seconds have 

laps d. The timer will NOT be canceled if the current greenlet has 
xited before the timer fires. 

seconds: The number of seconds to wait. 
cb: The callable to call after the given time. 

*args: Arguments to pass to the callable when called. 

**kw: Keyword arguments to pass to the callable when called. 

































































t = timer.Timer(seconds, cb, *args, **kw) 
self.add timer (t) 
return t 











注释 中 提 到 的 timer 是 指 ， 传 递 进来 的 参数 会 构造 成 timer 的 实例 最 后 添加 到 self.next_timer 列 表 中 。 注 意 在 spawn 中 传递 进来 的 9.switch 逊 数 ， 如 果 调 用 了 这 个 g.switch 函 数 ， 则 触 故 了 它 所 在 的 
greenthread 的 运行 。 


这 三 步 结束 之 后 ， 对 spawn 的 调用 就 返回 了 ， 然 而 现在 只 是 创建 了 一 个 GreenThread， 还 没有 调度 它 去 执行 ， 最 后 还 需要 在 返回 的 结果 上 调用 g.wait () 方法 ， 这 样 就 开始 GreenThread 的 神奇 之 旅 


下 面 是 GreenThread 的 wait 方 法 的 具体 代码 : 









































def init (self, parent): 
gre nlet.greenlet. init (self, self.main, parent) 
self. exit event = event.Event () 
self. resolving links = False 














def wait (self): 
""" Returns the result of the main function of this GreenThread. If the 
result is a normal return value, :meth: wait' returns it. If it raised 
an exception, :meth: wait’ will raise the same exception (though the 
Stack trace will unavoidably contain some frames from within the 
greenthread module).""" 

return self. exit event.wait () 




























































































其 中 ，wait 方 法 调用 了 Event 实 例 的 wait 方 法 ， 也 就 是 说 ，wait 函 数 调 用 了 我 们 前 面 提 到 的 单 态 实例 hub 的 switch 方 法 ， 然 后 该 switch 真 正 地 去 调用 hub 的 self.greenlet.switch () ， 该 greenlet 是 所 有 
调用 spwan 创 建 的 greenlet 的 父 greenlet， 该 self.greenlet 在 初始 时 传递 了 一 个 self.run 方 法 ， 就 是 所 谓 的 MAINLOOP。 最终 ， 程 序 的 运行 会 由 于 switch 的 调用 ， 开 始 run 方 法 中 的 while 循 环 ， 这 是 多 线程 
开发 者 最 熟悉 的 while 循 环 了 


在 该 while 循 环 中 ， 对 self.next timers 中 的 timers 做 处 理 : 





def prepare timers (self): 
heappush - heapq. heappush 
t = self.timers 


for item in self.next timers: 


















































if item[1].called: 
self.timers canceled -= 1 

else: B 

heappush(t, item) 














del self.next timers[:] 


首先 处 理 next timers 中 没有 被 调用 的 timer， 放 到 最 小 堆 中 去 ， 也 就 是 时 间 最 小 者 排 前 面 ， 越 先 被 执行 。 然 后 将 所 有 已 经 调用 了 的 timer 删 除 掉 ， 这 时 会 有 一 个 疑问 : 如 果 删 除 的 timer 没 有 运行 结束 ， 
那么 下 次 岂 不 是 没有 机 会 再 被 调度 来 运行 了 ”在 了 解 了 greenthread.py 中 的 sleep 函 数 之 后 ， 就 会 明白 这 个 问题 。 


加 入 到 heap 中 的 timer 会 按照 顺序 依次 遍历 ， 如 果 到 了 它们 的 执行 时 间 点 了 ，timer 对 象 就 会 直接 被 调用 。 看 下 面 的 代码 : 














def fire timers(self, when): 
t — self.timers 

heappop = heapq.heappop 
while t: 

next = t[0] 

exp = next [0] 

timer = next[1] 

if when < exp: 

break 

heappop (t) 

try: 

if timer.called: 

self.timers canceled -- 1 


























timer () 
except self.SYSTEM EXCEPTIONS: 





























except: 
self.squelch timer exception(timer, sys.exc info()) 
clear sys exc info() 

















timer 对 象 重 载 了 _call_ 方 法， 所 以 可 以 直接 调用 ，timer 被 调用 之 后 ， 我 们 前 面 知道 ， 传 递 进 来 的 是 g.switch， 在 timer 中 就 是 调用 了 该 switch 函 数 ， 直 接触 动 了 greenthread 的 执行 ， 此 时 ， 我 们 自 定 
义 的 函数 融 可 以 被 执行 了 


如 果 我 们 自 定 义 的 函数 要 运行 时 间 很 长 ， 其 他 的 greenthread 则 没有 机 会 去 运行 了 ， 怎 么 处 理 ?” OpenStack Nova 官 方 文档 介绍 thread 时 也 提 到 这 个 问题 ， 此 时 我 们 需要 在 自己 定义 的 函数 中 调用 
greenthread.sleep (0) 函数 以 进行 切换 ， 使 其 他 的 greenthread 也 能 被 调度 运行 。 下 面 来 看 一 下 greenthread.sleep 函 数 的 代码 。 








sleep (seconds=0) : 
"""Yield control to another eligible coroutine until at least *seconds* have 
elapsed. 

















*seconds* may be specified as an integer, or a float if fractional seconds 
are desired. Calling :func: ^greenthread.sleep' with *seconds* of 0 is the 
canonical way of expressing a cooperative yield. For example, if one is 



































looping over a large list performing an expensive calculation without 
calling any socket methods, it's a good idea to call ``sleep(0)`` 
occasionally; otherwise nothing else will run. 

















hub = hubs.get hub() 
current = getcurrent() # 当前 正在 执行 的 greenthread， 调 用 这 个 sleep 函 数 
assert hub.greenlet is not current, 'do not call blocking functions from the mainloop' 
timer = hub.schedule call global(seconds, current.switch) 
try: 
hub.switch() 
finally: 
timer.cancel () 






































从 该 sleep 函 数 可 以 知道 ， 我 们 又 重新 调用 了 一 遍 hub.schedule_call global 函 数 ， 然 后 直接 调用 hub.switch， 这 样 在 运行 的 子 greenlet 中 ， 开 始 触发 父 greenlet (也 就 是 MAINLOOP 的 greenlet) AIH 
行 ， 上 次 该 greenlet 正 运行 到 fire_timers 的 timer () 函数 处 ， 此 时 父 greenlet 则 接着 运行 ， 开 始 新 的 调度 。 至 此 ， 调 度 的 过 程 就 大 致 描述 结束 了 。 


greenthread 中 的 其 他 函数 都 基本 类 似 ， 如 果 国 数 只 是 简单 地 进行 CPU 运行 ， 而 不 涉及 MO 处 理 ， 通 过 上 面 的 知识 就 可 以 理解 Eventlet 了 ， 然 而 ，Eventlet 是 一 个 高 性 能 的 网 络 库 ， 还 有 很 大 一 部 分 是 跟 
网 络 相关 的 。 


44 WSGI 


44.1 RESTful API 介 绍 
RESTful 是 目前 流行 的 一 种 互联 网 软件 架构 。REST (Representational State Transfer) 表述 状态 转移 ， 最 早 是 由 Roy Thomas Fielding 在 他 2000 年 的 博士 论文 中 提出 的 ， 定 义 了 他 对 互联 网 软件 的 架 
构 原 则 ， 如 果 一 个 架构 符合 REST 原 则 ， 就 称 它 为 RESTful 架 构 。 


RESTful| 架 构 的 一 个 核心 概念 是 “资源 ” (resource) 。 从 RESTful 的 角度 看 ， 网 络 里 的 任何 东西 都 是 资源 ， 它 可 以 是 一 段 文本 、 一 张 图 片 、 一 首 歌曲 、 一 种 服务 等 ， 每 个 资源 都 对 应 一 个 特定 的 
URL (统一 资源 定位 符 ) 并 用 它 进行 标示 ,访问 这 个 URL 就 可 以 获得 这 个 资源 。 


资源 可 以 有 多 种 具体 表现 形式 ， 也 就 是 资源 的 “表述 ” (representation) ， 例 如 ， 一 张 图 片 可 以 使 用 JPEG 格 式 ， 也 可 以 使 用 PNG 格 式 。URL 只 是 代表 了 资源 的 实体 ， 并 不 能 代表 它 的 表现 形式 。 


在 互联 网 中 ， 客 户 端 和 服务 端 之 间 进 行 互动 传递 的 就 只 是 资源 的 表述 ， 我 们 上 网 的 过 程 就 是 调用 资源 的 URL， 获 取 它 不 同 表现 形式 的 过 程 。 这 个 互动 只 能 使 用 无 状态 协议 HTTP， 也 就 是 说 ， 服 务 端 必须 
保存 所 有 的 状态 ， 客 户 端 可 以 使 用 HTTP 的 几 个 基本 操作 ， 包 括 GET (获取 ) 、POST (创建 ) 、PUT (更 新 ) 、DELETE (MIR) ， 使 服务 端 上 的 资源 发 生 状 态 转化 (State Transfer) ， 也 就 是 所 谓 的 “ 表 
述 性 状态 转移 ”。 


OpenStack 各 个 项 目 都 提供 了 RESTful 架 构 的 API 作 为 对 外 提供 的 接口 ， 而 RESTful 架 构 的 核心 是 资源 与 资源 上 的 操作 ， 也 就 是 说 ，OpenStack 定 义 了 很 多 的 资源 ， 并 实现 了 针对 这 些 资源 的 各 种 操作 函 
数 。Openstack 的 API 服 务 进程 接收 到 客户 端的 HTTP 请 求 时 ， 一 个 所 谓 的 “路 由 ”模块 会 将 请 求 的 URL 转 换 成 相应 的 资源 ， 并 路 由 到 合适 的 操作 函数 上 。 


Openstack 中 所 使 用 的 路 由 模块 Routes 源 自 于 对 Rails (Ruby on Rails) 路 由 系统 的 重新 实现 。Rails 是 Ruby 语 言 的 Web 开 发 框架 ， 采 用 MVC (Model-View-Controller) 模式 ， 收 到 浏览 器 发 出 的 
HTTP 请 求 后 ，Rails 路 由 系统 会 将 这 个 请 求 指派 到 对 应 的 Controller， 可 以 参考 如 下 的 网 址 : http://routes.readthedocs.org。 


4.4 WSGI 


4.4.1 RESTful API 介 绍 
RESTful 是 目前 流行 的 一 种 互联 网 软件 架构 。REST (Representational State Transfer) 表述 状态 转移 ， 最 早 是 由 Roy Thomas Fielding 在 他 2000 年 的 博士 论文 中 提出 的 ， 定 义 了 他 对 互联 网 软件 的 架 
构 原 则 ， 如 果 一 个 架构 符合 REST 原 则 ， 就 称 它 为 RESTful 架 构 。 


RESTful 架 构 的 一 个 核心 概念 是 “资源 ” (resource) 。 从 RESTful 的 角度 看 ， 网 络 里 的 任何 东西 都 是 资源 ， 它 可 以 是 一 段 文本 、 一 张 图 片 、 一 首 歌 曲 、 一 种 服务 等 ， 每 个 资源 都 对 应 一 个 特定 的 
URL (统一 资源 定位 符 ) 并 用 它 进行 标示 ， 访 问 这 个 URL 就 可 以 获得 这 个 资源 。 


资源 可 以 有 多 种 具体 表现 形式 ， 也 就 是 资源 的 “表述 ” (representation) ， 例 如 ， 一 张 图 片 可 以 使 用 JPEG 格 式 ， 也 可 以 使 用 NG 格式。URL 只 是 代表 了 资源 的 实体 ， 并 不 能 代表 它 的 表现 形式 。 


在 互联 网 中 ， 客 户 端 和 服务 端 之 间 进 行 互动 传递 的 就 只 是 资源 的 表述 ， 我 们 上 网 的 过 程 就 是 调用 资源 的 URL， 获 取 它 不 同 表现 形式 的 过 程 。 这 个 互动 只 能 使 用 无 状态 协议 HTTP， 也 就 是 说 ， 服 务 端 必须 
保存 所 有 的 状态 ， 客 户 端 可 以 使 用 HTTP 的 几 个 基本 操作 ， 包 括 GET (获取 ) 、POST (创建 ) 、PUT (更 新 ) 、DELETE (MIR) ， 使 服务 端 上 的 资源 发 生 状 态 转化 (State Transfer) ， 也 就 是 所 谓 的 “ 表 
述 性 状态 转移 ”。 


OpenStack 各 个 项 目 都 提供 了 RESTful 架 构 的 API 作 为 对 外 提供 的 接口 ， 而 RESTful 架 构 的 核心 是 资源 与 资源 上 的 操作 ， 也 就 是 说 ，OpenStack 定 义 了 很 多 的 资源 ， 并 实现 了 针对 这 些 资源 的 各 种 操作 函 
数 。Openstack 的 API 服 务 进程 接收 到 客户 端的 HTTP 请 求 时 ， 一 个 所 谓 的 “路 由 ”模块 会 将 请 求 的 URL 转 换 成 相应 的 资源 ， 并 路 由 到 合适 的 操作 函数 上 。 


Openstack 中 所 使 用 的 路 由 模块 Routes 源 自 于 对 Rails (Ruby on Rails) 路 由 系统 的 重新 实现 。 Rails 是 Ruby 语 言 的 Web 开 发 框架 ， 采 用 MVC (Model-View-Controller) 模式 ， 收 到 浏览 器 发 出 的 
HTTP 请 求 后 ，Rails 路 由 系统 会 将 这 个 请 求 指派 到 对 应 的 Controller， 可 以 参考 如 下 的 网 址 : http://routes.readthedocs.org, 


4.4.2 WSGI 简 介 


Web 应 用 的 本 质 : 
- 浏览 器 发 送 一 个 HTTP 请 求 。 
- 服务 器 收 到 请 求 ， 生 成 一 个 HIMIL 文 档 。 


- 服务 器 把 HIML 文档 作为 HITP 响 应 的 Body 发 送 给 浏览 器 。 


所 以 ， 最 简单 的 Web 应 用 就 是 先 把 HTML 用 文件 保存 好 ， 用 一 个 现成 的 HTTP 服 务 器 软件 接收 用 户 请 求 ， 从 文件 中 读 取 HTML， 并 返回 。Apache、Nginx、Lighttpd 等 这 些 常见 的 静态 服务 器 就 是 处 理 
这 件 事情 的 。 


如 果 要 动态 生成 HTML， 就 需要 自己 来 实现 上 述 步 又。 不 过 ， 接 受 HTTP 请 求 、 解 析 HTTP 请 求 、 发 送 HTTP 响 应 都 是 苦力 活 ， 如 果 我 们 自己 来 写 这 些 底层 代码 ， 需 要 耗费 大 量 的 时 间 和 精力 。 正 确 的 做 法 
是 底层 代码 由 专门 的 服务 器 软件 实现 ， 我 们 用 Python 专注 于 生成 HTML 文 档 。 因 为 我 们 不 希望 接触 到 TCP 连 接 、HTTP 原 始 请 求 和 响应 格式 ， 所 以 ， 需 要 一 个 统一 的 接口 ， 让 我 们 专心 用 Python 编写 Web 业 
务 。 这 个 接口 就 是 WSGI (Web Server Gateway Interface) , 


Django、CherryPy 都 自 带 WSGI Server， 主 要 用 于 测试 ， 发 布 时 则 使 用 生产 环境 的 WSGI Server， 而 有 些 WSGI 下 的 框架 ， 如 pylons、bfg 等 ， 自 己 不 实现 WSGI Server,， 而 是 使 用 paste 作 为 WSGI 
server 和 CherryPy 的 WSGI server 实 现 的 。 


WSGI 有 两 方 : 服务 器 方 和 应 用 程序 ， 如 图 4-3 所 示 。 


Server 


BROWSER 





图 4-3 ”服务 器 方 和 应 用 程序 示意 图 
1) 服务 器 方 : 其 调用 应 用 程序 ， 给 应 用 程序 提供 环境 信息 和 回调 函数 ， 这 个 回调 函数 用 来 将 应 用 程序 设置 的 HTTP Header 和 Status 等 信息 传递 给 服务 器 方 。 


2) 应 用 程序 : 用 来 生成 返回 的 Header、Body 和 Status， 以 便 返 回 给 服务 器 方 。 


4.4.3 ”简单 的 WSGI 


WsGI 接 口 定义 非常 简单 ， 它 只 要 求 Web 开 发 者 实现 一 个 国 数 ， 就 可 以 响应 HTTP 请 求 。 下 面 来 看 一 个 最 简单 的 Web 版 本 的 “Hello，web! " : 


def application(environ, start response): 
start response('200 OK', [('Content-Type', 'text/html')]) 
return '<hl>Hello, web!«/hl» 








上 面 的 application () 函数 是 一 个 符合 WSGI 标 准 的 HTTP 处 理 函 数 ， 它 接收 两 个 参数 : 
environ; 一 个 包含 所 有 HTTP 请 求 信息 的 dict 对 象 。 
"statt response: — 4M A iÉHTTIP»(9 9 86 yf icc 


在 application () 函数 中 ， 调 用 : 


start response('200 OK', [('Content-Type', 'text/html')]) 


就 友 送 了 HTTP 响 应 的 Header。 注 意 ，Header 只 能 发 送 一 次 ， 即 只 能 调用 一 次 start_response () Bax. start response () 国 数 接收 两 个 参数 ， 一 个 是 HTTP 响 应 码 ， 另 一 个 是 一 组 list 表 示 的 HTTP 
Header， 每 个 Header 用 一 个 包含 两 个 str 的 tuple 表 示 。 


通常 情况 下 ， 应 该 把 Content-Type 头 发 送 给 浏览 器 。 其 他 很 多 常用 的 HTTP Header 也 应 该 发 送 。 然 后 ， 函 数 的 返回 值 <h1>Hello，web! «/h1» 将 作为 HTTP 响 应 的 Body 发 送 给 浏览 器 。 


有 了 WSGI， 我们 关心 的 就 是 如 何 从 environ 这 个 dict 对 象 拿 到 HTTP 请 求 信息 ， 然 后 构造 HTML， 通 过 start_response () 发 送 Header， 最 后 返回 gody。 整 个 application () ARARAS KERE 
析 HTTP 的 部 分 ， 也 就 是 说 ， 底 层 代码 不 需要 我 们 自己 编写 ， 我 们 只 负责 在 更 高 层次 上 考虑 如 何 响应 请 求 就 可 以 了 。 不 过 ， 这 个 application () 函数 怎么 调用 ? 如 果 我 们 自己 调用 ， 我 们 没 法 提供 environ 和 
start_response 这 两 个 参数 ， 返 回 的 str 也 没 法 发 给 浏览 器 。 所 以 application () 函数 必须 由 WsGI 服 务 器 来 调用 。 目 前 有 很 多 符合 WsGI 规 范 的 服务 器 ， 我 们 可 以 从 中 挑选 一 个 。 但 是 现在 ， 我 们 只 想 尽快 测 
试 一 下 我 们 编写 的 application () 函数 真 的 可 以 把 HTML 输 出 到 浏览 器 ， 所 以 ， 要 赶紧 找 一 个 最 简单 的 WsGI 服 务 器 ， 把 Web 应 用 程序 运行 起 来 。 


Python 内 置 了 一 个 WSGI 服 务 器 ， 这 个 模块 称 为 wsgiref， 它 是 用 纯 Python 编 写 的 WSGI 服 务 器 的 参考 实现 。 所 谓 “参考 实现 ”是 指 该 实现 完全 符合 WsGl 标 准 ， 但 是 不 考虑 任何 运行 效率 ， 仅 供 开 发 和 


测试 使 用 。 


4.4.4 运行 WsGI 服 务 


首先 编写 hello.py， 实 现 Web 应 用 程序 的 WSGI 处 理 函 数 : 


f hello.py 


def application(environ, start response): 
start response('200 OK', [('Content-Type', 'text/html')]) 
eturn '«hl»Hello, web!«/hl»' 





H 





然后 编写 server.py， 负 责 启 动 WSGI 服 务 器 ， 加 载 application () 函数 : 


f server. 

# 从 wsgiref 模 块 导入 : 

from wsgiref.simple server import make server 
# 导入 我 们 自己 编写 Happlicationr žit: 


from hello import application 


# 创建 一 个 服务 器 ， ITP 地 址 为 空 ， 端口 是 8000， 处 理 函 数 是 application: 

ttpd = make server('', 8000, application) 

rint "Serving HTTP on port 8000http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/..." 
开始 监听 HTTP 请 求 : 

ttpd.serve forever () 
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确保 以 上 两 个 文件 在 同一 个 目录 下 ， 然 后 在 命令 行 输入 python server.py 来 启动 WSGI 服 务 器 ， 如 图 4-4 所 示 。 


[rootücontrol ~|# python server.py 
Serving HTTP on port 8000. 


图 4-4 ”启动 WSGI 服 务 器 后 


oor 


如 果 8000 端 口 已 被 其 他 程序 占用 ， 启 动 将 失败 ， 请 修改 成 其 他 端口 。 


启动 成 功 后 ， 打 开 浏 览 器 ,输入 http://localhost:8000/， 就 可 以 看 到 结果 了 ， 如 图 4-5 所 示 。 


在 命令 行 可 以 看 到 wsgiref 输 出 的 log 信 息 ， 如 图 4-6 所 示 。 按 Ctrl+ 5 组合 键 可 终止 服务 。 
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DO | 10.20.0.50:8000 | + E 5 


Hello, web! 


好 ) 令 日 直播 []emswms © Nis JT F € O d) Q100% 


[root&control ~]# python server .py 


Serving HTTP on port 8000... | 
10.20.0.200 - - [01/Nov/2016 19:53:53] "GET / HTTP/1.1" 200 20 | 
10.20.0.200 - - [01/Nov/2016 19:54:02] "GET /favicon.ico HTTP/1.1" 200 20 





E-6 ”终端 的 输出 结果 


如 果 觉 得 这 个 Web 应 用 太 简单 了 ， 可 以 稍微 改造 一 下 ， 从 environ 里 读 取 PATH_INFO， 这 样 可 以 显示 更 加 动态 的 内 容 : 





f hello.py 


def application(environ, start response): 
start response('200 OK', [('Content-Type', 'text/html')]) 
return '<hl>Hello, %s!</hl>' $ (environ['PATH INFO'][1:] or 'web') 














可 以 在 地 址 栏 输 入 用 户 名 作为 URL 的 一 部 分 ， 将 返回 Hello，xxx! ， 如 图 4-7 所 示 。 






10.20.0.50:800( 









I^ | © | 10.20.0.50:8000/admir | + B 5 


Hello, admin! 


外 今日 直播 []smosss © pimes JTE P £ O q) Q00% 
图 4-7 URL 的 浏览 器 结果 显示 


小 结 : 
无 论 多 么 复杂 的 Web 应 用 程序 ， 入 口 都 是 一 个 WSGI 处 理 函 数 。HTTP 请 求 的 所 有 输入 信息 都 可 以 通过 environ 获 得 ，HTTP 响 应 的 输出 都 可 以 通过 start_response () 加 卢 数 返回 值 作为 Body。 


复杂 的 Web 应 用 程序 ， 光 靠 一 个 WSGI 浮 数 来 处 理 还 是 太 底 层 了 ， 需 要 在 WSGI 之 上 再 抽象 出 Web 框 架 ， 进 一 步 简 化 Web 开 发 。 


44.5 Middleware 


WSGI 中 可 以 添加 中 间 件 ， 如 图 4-8 所 示 。 


Middleware 


Secvec 





图 4-8 WSGI 中 间 件 示意 图 


带 过 滤器 的 WSGI 服 务 代码 如 下 : 





from wsgiref import simple server 
From paste.pony import make pony 








def app(env, start response): 
status = '200 OK' 








output = 'Hello World' 
response headers = [('Content-Type', 'text/html')] 
start response(status, response headers) 





return [output] 


app = make pony(app, dict()) 
server = simple server.make server('0.0.0.0',8080, app, 
simple server.WSGIServer) 














server.serve forever () 








在 这 中 间 可 以 添加 多 个 Middleware， 如 图 4-9 所 示 。 


Aplication 


Framework com 
Interface WSGI 


Middleware WSGI 


Middleware WSGI 


Middleware WSGI 


Servidor WSGI 





图 4-9 ”多 个 Middleware 示 意图 


4.5 PasteDeploy 


PasteDeploy 是 WSGI 的 一 种 实现 方案 ，WSGI 工 具 包 包括 多 线程 ，SSL 和 基于 Cookies、sessions 等 的 验证 (authentication) 库 等 ， 让 应 用 管理 和 实现 变 得 方便 。 
PasteDeploy 在 Openstack 当 中 使 用 广泛 ，PasteDeploy 定 义 的 几 类 部 件 如 表 4-5 所 示 。 


表 4-5 ”PasteDeploy 部 件 表 


部 件 名 描述 
app WSGI 服务 的 核心 部 分 ， 用 于 实现 WSGI 服务 的 主要 逻辑 
filter 一 般 用 于 一 些 准备 性 工作 ， 如 验证 用 户 身 份 、 准 备 服 务 硕 环境 等 。 在 一 个 filter 执行 完毕 以 后 ， 可 
以 直接 返回 ， 也 可 以 交 给 一 个 filter 或 者 APP 继续 执行 
pipeline HT filter 和 一 个 app 组 成 。 通 过 pipeline， 可 以 很 容易 地 定制 复杂 的 WSGI 服务 


composite 用 于 实现 复杂 的 应 用 程序 ， 可 以 进行 分 文选 择 。 例 如 ， 可 以 根据 不 同 的 URL 调用 不 同 的 处 理 程 序 


4.5.1 ”PasteDeploy 安 装 


Paste Deploy 的 安装 有 两 种 方式 ， 下 面 将 举例 说 明 。 


1) 通过 pip 来 安装 : 





PipinstallPasteDeploy 


2) 通过 源码 安装 : 





Git clonehttp://bitbucket.org/ianb/pastedeploy 
Cdpastedeploy 
Pythonsetup.pydevelop 





4.5.2 Paste 配置 文件 


配置 文件 由 若干 section 组 成 ，section 的 声明 格式 如 下 : 


[type: name] 





其 中 ， 方 括号 括 起 的 section 声 明 一 个 新 section 的 开始 ，section 的 声明 由 两 部 分 组 成 ，section 的 类 型 (type) 和 section 的 名 称 (name) , 2: [app: main] 等 。section 的 type 可 以 有 : app. 


composite、filter、pipeline、filter-app 等 。 


下 面 的 配置 文件 中 ，“metadata” 复 合 application ， 人 入口 为 urImap， 根 据 url 不 同 实现 跳 转 。 





[composite:metadata] 
use = egg:Paste#urlmap 
/: meta 
[pipeline:meta] 
pipeline = ec2faultwrap logrequest metaapp 

[app:metaapp] 

paste.app factory - nova.api.metadata.handler:MetadataRequestHandler.factory 




















加 载 配置 文件 : 





from paste.deploy import loadapp 
wsgi app = loadapp('config:/path/to/config.ini') 








1. 配 置 文件 第 一 段 





[composite:name] 

[composite:osapi compute] 

use = call:nova.api.openstack.urlmap:urlmap factory 
/: oscomputeversions 
/V1.1: openstack compute api v2 
/v2: openstack compute api v2 














[composite:openstack compute api v2] 
use = call:nova.api.auth:pipeline factory 















































noauth = faultwrap sizelimit noauth ratelimit osapi compute app v2 
keystone = faultwrap sizelimit authtoken keystonecontext ratelimit osapi compute app v2 
keystone nolimit = faultwrap sizelimit authtoken keystonecontext osapi compute app v2 





[composite:openstack compute api v3] 
use = call:nova.api.auth:pipeline factory v3 

noauth = faultwrap sizelimit noauth v3 osapi compute app v3 

keystone = faultwrap sizelimit authtoken keystonecontext osapi compute app v3 









































2. 配 置 文件 第 二 段 





[app :name ] 


指向 另外 一 个 配置 文件 : 





[app :myapp] 
use — config:another conf 








Ju. 











g file.ini 


指向 URL: 


[app:myotherapp] 
use = egg:MyApp 





指向 某 个 模块 里 的 可 调用 函数 : 


[app:mythirdapp] 
use = call:my.project:myapplication 





指向 另外 一 个 section : 








[app:myfourthapp] 
use = myotherapp 


指向 模块 : 














[app:myfifthapp] 
paste.app factory -myapp.modulename:app factor 











3. 配 置 文件 第 三 段 





[filter:name] 


与 app 性 质 类 似 ， 用 法 和 app 类 似 ， 示 例如 下 : 








[filter:ec2faultwrap] 
paste.filter factory = nova.api.ec2:FaultWrapper.factory 


























4. 配 置 文件 第 四 段 


[pipeline:name] 
[pipeline:meta] 
pipeline = ec2faultwrap logrequest metaapp 











pipe 的 初始 化 过 程 如 图 4-10 所 示 。pipe 的 执行 过 程 如 图 4-11 所 示 。 





图 4-10 ”初始 化 过 程 





5. 配 置 文件 第 五 段 











paste.app factory 
paste.filter factory 
paste.compsite factory 
paste.filter app factory 
paste.server factory 



































[app:oscomputeversionapp] 
paste.app factory - nova.api.openstack.compute.versions:Versions.factory 























4.5.3 ”改进 WsGI 


下 面 我 们 举例 说 明 如 何 改进 WSGI。 





fapi-paste.ini 
[app:main] 
paste.app factory - wsgi paste:app factory 








fwsgi paste.py 

from webob import Response 

from webob.dec import wsgify 
from paste import httpserver 
from paste.deploy import loadapp 
import os 

import sys 


























ini path - os.path.normpath( 
os.path.join(os.path.abspath (sys.argv[0]), 


OS.pardir, 
'api-paste.ini') 


) 





Qwsgify 


def 


application (request): 











return Response('Hello, World of WebOb !\n") 





def 











app factory (global config, **local config): 











return application 








if 
pri 
exi 


wsg 


httpserver.serve (wsgi app, host='127.0.0.1', port-8080) 








not os.path.isfile(ini path): 
nt ("Cannot find api-paste.ini. Nn") 
t(1) 














i app = loadapp('config:' + ini path) 





4.6 


WebOb 


WebOb 是 一 个 Python 的 包 ， 它 主要 的 作用 是 对 WSGI 的 request 进 行 修饰 ， 以 及 帮助 生成 WSGI 的 response。 


4.6.1 


Pythonze(asithA 


装饰 器 用 于 把 函数 包装 一 下 ， 其 本 质 是 一 个 函数 ， 即 参数 为 被 包装 的 函数 ， 返 回 包装 后 的 函数 。 


装饰 器 适合 以 下 应 用 场景 : 


: 频繁 的 同类 型 操作 。 


装 


改变 函数 或 者 方法 的 行为 。 


饰 器 的 核心 是 “一 个 中 心 ， 两 个 基本 点 ”， 具 体 解释 如 下 : 


* 一 个 中 心 是 @ 符 号 ， 例如: 


@log 


de 





f hello(): 


print "hello" 





两 个 基本 点 是 作用 域 、 闭 包 ， 例 如 : 





de 








def 


f wrap (func): 
f wrap(*args, **kwargs): 





re 
rg 





turn func(*args, **kwargs) 





turn Wrap 


4.6.2 ”简单 示例 


下 面 的 例子 实现 一 个 8080 端 口 的 wed 功 能 ， 并 返回 简单 的 信息 。 


#w 





sgi webob.py 


from webob import Response 

from webob.dec import wsgify 
from paste import httpserver 
from paste.deploy import loadapp 























N 








Qw 
de 
pr 
pr 
re 


def 


re 


| PATH = '/home/lucifer/wsgi webob.ini' 





sgify 

f application (reg): 

int req.body 

int req.params 

turn Response('Hello, World of WebOb !') 























app factory (global config, **local config): 











WS 


httpserver.serve(wsgi app, host='0.0.0.0', port=8080) 


turn application 














gi app = loadapp('config:' + INI PATH) 








fapi-paste.ini 
[app:main] 
paste.app factory - wsgi webob:app factory 








4.6.3 ”添加 自己 的 中 间 件 


上 面 的 示例 非常 简单 ， 现 在 增加 一 个 认证 的 中 间 件 “filter”， 将 代码 逻辑 设 


置 为 只 有 通过 认证 的 用 户 才能 返回 结果 ， 代 码 实现 如 下 : 





#wsgi_webob.py 





from webob import Response 

from webob.dec import wsgify 
from  webob Import exc 

from paste import httpserver 
from paste.deploy import loadapp 
































NI PATH = '/home/lucifer/wsgi webob.ini' 





Qwsgify 

def application (reg): 

print req.body 

print req.params 

return Response('Hello, World of WebOb !') 

















@wsgify.middleware 
def auth filter(req, app): 

















if request.headers.get ('X-Auth-Token') != 'open-sesame': 
return exc.HTTPForbidden () 
return app (req) 




















def app factory(global config, **local config): 
return application 

















def filter factory(global config, **local config): 
return auth filter 





























wsgi app = loadapp('config:' + INI PATH) 
httpserver.serve(wsgi app, host-'0.0.0.0', port-8080) 








fapi-paste.ini 

[pipeline:main] 

pipeline = auth hello 
[app: hello] 
paste.app factory = wsgi webob mid:app factory 
[filter:auth] B B iB 
paste.filter factory = wsgi webob mid:filter factory 


















































464 ”其 他 特性 


WebOb 本 身 也 是 WSGI 标 准 的 一 种 实现 ， 但 具有 自己 的 一 些 特性 : 
© 完全 可 以 只 使 用 WebOb 构 建 WSGI 应 用 。 
提供 了 更 好 的 处 理 。 


“ 对 JSON 提 供 了 良好 支持 。 


4.7 routes 模 块 


4.7.1 “routes 模 块 概述 


OpenStack 中 所 使 用 的 路 由 模块 routes 源 自 于 对 Rails 路 由 系统 的 重新 实现 。Rails 是 Ruby 语 言 的 Web 开 发 框架 ， 采 用 MVC 模 式 ， 收 到 浏览 器 发 出 的 HTTP 请 求 后 ，Rails 路 由 系统 会 将 这 个 请 求 指派 到 对 
应 的 Controller。 


4.7 routes 模 块 


4.7.1 ”routes 模 块 概述 


Openstack 中 所 使 用 的 路 由 模块 routes 源 自 于 对 Rails 路 由 系统 的 重新 实现 。Rails 是 Ruby 语 言 的 Web 开 发 框架 ， 采 用 MVC 模 式 ， 收 到 浏览 器 发 出 的 HTTP 请 求 后 ，Rails 路 由 系统 会 将 这 个 请 求 指派 到 对 
应 的 Controller。 


4.7.2 ”使 用 示例 


下 面 用 示例 简单 了 解 routes 模 块 的 使 用 方法 。 











from wsgiref.simple server import make server 


import routes.middleware 
import webob.dec 
import webob.exc 





class Controller: 
Qwebob.dec.wsgify 
def call (self, reg): 
return webob.Response ("Hello World!") 

















class Routes (object): 
def init (self): 
self. mapper = routes.Mapper () 
self. mapper.connect ('/spch', 
controller-Controller(), 
action-'index', 
conditions={'method': ['GET'])) 












































self. router = routes.middleware.RoutesMiddleware (self. dispatch, self. mapper) 











Qwebob.dec.wsgify 
def call (self, reg): 

















return self. router 





@staticmethod 

@webob.dec.wsgify 
def dispatch (req): 
match = req.environ['wsgiorg.routing args'] [1] 











if not match: 
return webob.exc.HTTPNotFound() 


app = match['controller'] 
return app 


app = Routes () 
httpd = make server('localhost', 8282, app) 
httpd.serve forever () 

















48 综合 实例 


有 这 样 一 个 虚拟 机 管理 的 WSGI 服 务 。 用 户 可 以 通过 发 送 HTTP 请 求 来 实现 对 虚拟 机 的 管理 (包括 创建 、 查 询 、 更 新 以 及 删除 虚拟 机 等 操作 ) 。 当 然 ， 为 了 简单 起 见 ， 这 个 WsGI 服 务 不 会 真 在 物理 机 上 
创建 虚拟 机 ， 只 是 在 服务 中 保存 相应 的 虚拟 机 记录 而 已 。 


RESTful API 提 供 了 一 套 URL 的 规则 ， 在 本 节 的 示例 中 也 须 满足 这 样 的 规则 。 在 RESTful APl 中 ， 每 条 URL 都 是 与 资源 相对 应 的 。 一 个 资源 ， 可 能 是 一 个 集合 ， 也 可 能 是 一 个 个 体 。 集 合 通常 用 集合 的 标 
志 。 例 如 ， 在 本 节 的 示例 中 ， 使 用 instances 表 示 虚 拟 机 的 集合 ， 而 个 体 通 常用 统一 的 ID 标示 。 例 如 ， 在 示例 中 使 用 UUID 来 标示 虚拟 机 。 


对 集合 的 操作 通常 有 虚拟 机 的 添加 和 查询 ， 对 个 体 的 操作 通常 有 虚拟 机 的 查询 、 删 除 和 更 新 。 它 们 对 应 的 URL 如 表 4-6 所 示 。 


#46 ”虚拟 机 的 相关 操作 


类 型 描述 
"- FAAP PICTURE: 
获取 一 条 虚拟 机 记录 的 信息 
个 体操 作 更 新 一 条 虚拟 机 记录 的 信息 
/instances/{instance id! 删除 一 条 虚拟 机 记录 


{instance_id} 是 虚拟 机 的 UUID。 将 资源 的 1D 放 在 URL 中 ， 是 RESTful API 的 一 大 特点 。 


在 WSGI 中 ， 要 实现 URL 映 射 ， 主 要 依赖 于 Mapper 和 Controller 两 个 类 。Mapper 类 ， 顾 名 思 义 ， 是 用 于 实现 URL 的 映射 。 当 用 户 发 送 请 求 时 ，Mapper 类 会 根据 用 户 请 求 的 URL 及 其 方法 来 确定 处 理 的 
方法 。 而 Controller 类 ， 则 是 实现 了 处 理 HTTP 请 求 的 各 种 方法 。Mapper 类 是 routes 包 中 定义 好 的 类 ， 而 Controller 类 需要 自己 实现 。 


下 面 先 介绍 api-paster 配 置 文件 。 
1.api-paster 配 置 文 件 


api-paste.ini 本 置 文 件 示 例如 下 : 


[pipeline:main] 

pipeline = auth instance 
[app:instance] 
paste.app factory - routers:app factory 
[filter:auth] 
paste.filter factory = middleware:Auth.factory 









































可 以 看 到 ， 示 例 中 的 WSsGI 服 务 共 使 用 了 auth 过 滤器 和 instance 应 用 程序 两 个 部 件 。 其 中 ， 定 义 了 auth 过 滤器 ， 引 用 了 Auth 类 的 factory 方 法 作为 工厂 方法 ，hello 应 用 程序 引用 外 部 的 app_factory 作 为 
工厂 访 求 ; 还 定义 了 instance 应 用 程序 ， 对 的 工矿 方法 为 routers 包 的 app_factory 方 法 。 
2.URL 映 射 的 实现 


上 面 示例 中 的 WSGI 服 务 共 使 用 了 auth 过 滤器 和 instance 应 用 程序 两 个 部 件 。 其 中 ，auth 过 滤器 是 用 于 做 HTTP 头 认证 的 ， 比 较 简 单 。 核 心 功 能 都 在 instance 应 用 程序 中 实现 。instance 应 用 程序 对 应 的 
工厂 方法 为 routers 包 的 app_factory 方 法 。 下 面 就 来 看 一 下 app_factory 方 法 的 定义 : 














def app factory(global config, **local config): 
return Router () 














app_factory 方 法 返回 了 一 个 Router 对 象 。 前 面 说 过 ， 工 三 方法 必须 返回 一 个 函数 的 实例 ， 在 Router 类 中 ， 必 须 实现 _call_ 方 法 。 接 下 来 ， 就 看 一 下 Router 类 的 _call 方法 的 定义 。 


Qwsgify (RequestClass-webob.Request) 
def call (self, request): 
return self. router 




















call 方法 比较 简单 ， 它 返回 了 一 个 _router 变 量 ， 这 里 的 _router 变 量 其 实 是 一 个 可 调用 的 实例 。_call 方法 是 在 服务 器 接 到 HTTP 请 求 时 被 调用 的 。 当 服务 器 调用 _call 方法 时 ， 会 转 而 调用 _router 方 
法 。 因 此 ， 要 了 解 URL 映 射 的 流程 ， 就 必须 知道 router 变 量 的 定义 。 


_router 变 量 是 定义 在 Router 类 的 初始 化 方法 中 的 。 Router 类 的 初始 化 方法 定义 如 下 : 


class Router (object): 
def init (self): 














self.mapper = routes.Mapper () 
self.add routes() 




















self. router = routes.middleware.RoutesMiddleware (self. dispatch, 











self.mapper) 


Router 类 的 初始 化 方法 共 做 了 如 下 两 件 事 : 


1) 初始 化 mapper 成 员 变 量 。mapper 成 员 变 量 是 routes 包 Mapper 标 准 类 ， 它 主要 用 于 URL 解 村， 然后 调用 自身 的 add _ routes 方 法 往 Mapper 对 象 中 注册 URL 映 射 。 





2) 初始 化 _ router 成 员 变量 。_router 成 员 变 量 的 功能 是 将 HTTP 请 求 分 发 给 相应 的 方法 进行 处 理 。_router 成 员 变量 是 一 个 RoutesMiddleware 对 象 。 在 初始 化 时 ， 需 要 提供 两 个 参数 一 一 dispatch 方 法 
和 mapper 变 量 。 dispatch 方 法 是 Router 类 的 静态 方法 ， 它 的 功能 是 实现 HTTP 请 求 的 分 发 。RoutesMiddleware 对 象 ( 它 是 一 个 可 调用 的 实例 ) 的 执行 过 程 大 致 如 下 : 首先 通过 mapper 对 象 解析 信息 ， 然 


后 将 解析 结果 传递 过 dispatch 方 法 。 


下 面 分 析 实 现 URL 注 册 的 addroutes 方 法 ， 以 及 实现 分 发 HTTP 请 求 的 _dispatch 方 法 。 


(1) addroutes 方 法 


addroutes 方 法 实现 了 URL 注 册 的 功能 


























其 定义 如 下 : 





























def add routes (self): 

controller = controllers.Controller () 

self.m mapper. connect ("/instances", 
controller=controller, action="create", 
conditions-dict (method=["POST"] ) ) 
self.mapper.connect ("/instances", 
controller=controller, action="index", 
conditions-dict (method=["GET"] ) ) 

self .mapper.connect ("/instances/{instance id}", 
controller=controller, action="show", 
conditions-dict (method=["GET"] ) ) 

self .mapper.connect ("/instances/{instance id}", 
controller=controller, action="update", 
conditions-dict (method=["PUT"] ) ) 


self 








.mapper.co 


controller-con 


conditions-dict 


addroutes 方 法 共 添 加 了 五 条 URL 映 射 ， 各 条 URL 映 射 对 应 的 功能 参见 


于 解析 URL 的 类 类 的 connect 方 法 的 用 法 如 下 : 


nnect ("/inst 


tances/{instance id)", 














troller, ac! 





25, M 


(me 


apperz 


mapper.connect (<URL>, 
controller=<controller>, action=<action>, 


conditions=dict (me 


thod=["DELETE 





tion="delete", 


139 




















其 中 : 





<URL> 是 请 求 的 URL。 


<controller> 是 处 理 HTTP 请 求 的 controller 对 象 ， 


<action> 是 指 处 理 HTTP 请 求 的 方法 名 。 在 示例 中 的 <action> 对 应 的 方法 都 定义 在 controller 中 。 


thod=<method-list>) ) 


见 表 4-6。 在 添加 URL 映 射 时 ， 调 用 了 mapper 变 量 的 connect 方 法 。 


这 个 对 象 必须 是 可 调用 的 (实现 了 _call 方法 ) 。 


这 里 的 mapper 变 量 是 routes 包 中 定义 的 Mapper 类 


<method-list> 是 HTTP 请 求 的 方法 列表 。 在 RESTful APl 中 ， 定 义 了 GET、POST、PUT、HEAD 和 DELETE 等 方法 。 不 同 的 方法 对 应 了 资源 的 某 项 操作 。 


对 于 相同 的 URL， 若 其 HTTP 方 法 不 同 ， 对 应 的 处 理 方 法 也 可 能 不 同 。 上 面 代码 中 的 action 是 一 


(2) dispatch 方 法 


_dispatch 方 法 定义 如 下 : 


Qwsgif 
def 
tch 


ma 


@staticmet 
y (Reques 
dispatch ( 
= reques 











LE 
re 


app = 
turn app 


re 


_dispatch 方 法 首先 获取 URL 的 解析 结果 。 如 果 结 果 为 空 ， 则 说 明 相 应 的 URL 没 有 在 mapper 对 象 中 注册 。 此 时 ， 


not match: 


turn err () 


match['c 








hod 


request): 





ontroller'] 


tClass-webob.Request) 


t.environ['wsgiorg.routing args'][1] 





个 字符 串 ， 它 指 


通过 调用 _err 方 法 输出 错误 信息 。 


由 于 controller 对 象 也 是 可 调用 的 ， 因 此 最 终 WSGI 服 务 会 调用 controller 对 象 的 _call 方法 处 理 HTTP 请 求 。 


3.Controller 类 的 实现 


@wsgif 
def 


通过 上 面 的 分 析 可 以 知道 





a 





, req): 





action = arg dict.pop('a 


del 


me 


result = metho 


IE 


return webob. 
lse: 





arg dict[' 





controller' 





， 当 服务 器 接收 到 HTTP 请 求 时 ， 最 终 会 调用 Controller 类 


y (RequestClass-webob.Request) 
(self 
arg dict = req. cac ae S 





ction') 


] 











thod = getat 


result is N 





tr (self 
d(req, 


, ac 


one: 


tion) 


**arg dict) 














F not 
result = 








return 








result 


Response (body='', status='204 Not Found', 


isinstance (result, basest 
simplejson.dumps (result 


call 方法 可 以 分 为 三 个 部 


Controller 类 中 定义 的 方法 相对 比较 简单 。 下 面 仪 介 


(1) create 方 法 


create 方 法 的 功能 是 创建 一 条 虚拟 机 记录 ， 其 对 应 的 URL 是 POSTinstances。 在 发 送 请 求 时 ， 必 


def 








creat 


(self, 








req): 


print (req.params) 
name = req.params['name'] 





qu 


inst = 


self 
return ('instance': 


name: 


ring): 





— 


， 第 一 部 分 是 准备 参数 (4-9) | 


绍 create 和 show 两 个 方法 。 


inst id = str(uuid.uuid4()) 


['ig': 





.instances 


inst id, 'name': name] 
[inst id] - inst 
inst} 


headerlist=[ ('Content-Type', 


二 部 分 是 查找 并 执行 controller 中 相应 的 方法 (10~ 13) ; 


须 提 供 name 字 段 来 指 


的 _call 方法 。 接 下 来 ， 查 看 一 下 该 方法 的 定义 。 


'application/json')]) 


X ^ 


第 三 部 分 是 返回 


代码 中 的 self.instances 变 量 用 于 保存 虚拟 机 记录 的 字典 。 本 例 中 虚拟 机 的 信息 比较 简单 ， 只 有 id 和 name 两 个 字段 。 


(2) show 方 法 


定 的 是 方法 名 ， 而 不 是 方法 的 实例 。 


如 果 结 果 不 为 空 ， 


结果 (14~ 21) 。 


定 虚 拟 机 名 。create 方 法 的 定义 如 下 : 


s, CHJA 


则 返回 URL 相 应 的 controller 对 象 。 


show 方 法 的 功能 是 显示 一 条 虚拟 机 记录 的 信息 ， 其 对 应 的 URL 是 GET/instances/{instance_id}。Show 方 法 的 定义 如 下 : 


def show(self, req, instance id): 
inst = SE a Sees I ne ne du) 
return ('instance': inst] 

















4. 代 码 的 测试 

将 wsgi_instance 文 件 夹 下 的 代码 全 部 下 载 到 本 地 ， 然 后 在 该 文件 夹 下 执行 python service.py 启 动 WSGI 服 务 。 
在 WSGI 服 务 启动 后 ， 可 在 男 一 个 终端 进行 测试 。 下 面 对 示 例 中 定义 的 URL 进 行 测试 。 

1) GET/instances, 

2) POST/instances, 

3) GET/instances/(instance id}, 

4) PUT/instances/{instance id], 


5) DELETE/instances/(instance id}, 
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本 章 主 要 讲解 了 Openstack 中 用 到 的 Python 的 主要 模块 ， 并 给 出 部 分 示例 供 读者 学 习 。 


第 5 章 RabbitMQ 


本 章 主要 讲解 一 个 组 件 内 部 通信 的 消息 队列 RabbitMQ 服 务 。 


5.1 RabbitMQ 简 介 


RESTful APl 是 一 套 基于 HTTP 协 议 的 通信 机 制 ， 这 种 通信 机 制 存在 以 下 不 足 : 

1) 由 于 采用 HTTP 协 议 ， 客 户 端 服务 器 之 间 所 能 传递 的 信息 仅 限于 文本 。 

客户 端 与 服务 器 之 间 采 用 的 是 同步 机 制 。 当 发 送 HTTP 请 求 时 ， 客 户 端 需要 等 待 服务 器 的 响应 。 

2) 客户 端 与 服务 端 之 间 昌 然 可 以 独立 开发 ， 但 是 还 是 存在 耦合 。 例 如 ， 客 户 端 发 送 请 求 时 ， 必 须知 道 服务 器 的 地 址 ， 且 保证 服务 器 正常 工作 。 


基于 以 上 的 原因 ，Openstack 还 采用 了 另外 一 种 远程 通信 机 制 一 一 RPC 调 用 。 在 Openstack 中 ，RPC 采 用 AMQP 协 议 实现 进程 间 通 信 。 有 目前， 有 许多 工程 实现 了 AMQP 协 议 。Openstack 采 用 的 是 
RabbitMQ 和 Qpid， 这 里 只 对 RabbitM Q 进 行 分 析 。 


RabbitMQ 是 实现 了 高 级 消息 队列 协议 (Advanced Message Queuing Protocol, AMQP) 的 开源 消息 代理 软件 ( 亦 称 面向 消息 的 中 间 件 ) 。AMQP 是 一 个 定义 了 在 应 用 或 者 组 织 之 间 传 送 消 息 的 协 
议 的 开放 标准 (an open standard for passing business messages between applications or organizations) ， 它 最 新 的 版 本 是 1.0。AMQP 的 目标 在 于 解决 在 两 个 应 用 之 间 传 送 消 息 存在 的 问题 


. 网 络 是 不 可 靠 的 一 消息 需要 保存 后 再 转发 并 有 出 错 处 理 机 制 。 

. 与 本 地 调用 相 比 ， 网 络 速 度 慢 一 需要 异步 调用 。 

. 应 用 之 间 是 不 同 的 (如 不 同 语言 实现 、 不 同 操 作 系统 等 ) 一 需要 与 应 用 无 关 。 
. 应 用 会 经 常 变化 一 需要 与 应 用 无 关 。 

AMQP 使 用 异步 的 、 应 用 对 应 用 的 、 二 进 制 数据 通信 来 解决 这 些 问题 


RabbitMQ 是 AMQP 的 一 种 实现 ， 它 包括 Server (服务 器 端 ) . Client (客户 端 ) 和 Plugins ( 播 件 ) 。RabbitMQ 服 务 器 是 用 Erlang 语 言 编写 的 ， 其 最 新 版 本 是 3.4.4， 而 OpenStack Juno 中 使 用 的 
Server 是 3.2.4 版 本 。 现 在 RabbitMQ 支 持 的 AMQP 版 本 依然 是 0.9.1。 


RabbitMQ 特 点 : 

. 使 用 Edang 编 写 。 

“ 支持 持久 化 。 

| 支持 HA。 

- 提供 C#、Erlang、Java、Perfl、Python、Ruby 等 的 Client 开 发 端 。 
RabbitMQ 概 念 一 : 


: Broker: 简单 来 说 就 是 消息 队列 服务 器 实体 。 


‘Exchange: 消息 交换 机 ， 它 指定 消息 按 什么 规则 ， 路 由 到 哪个 队列 。 

‘Queue: 消息 队列 载体 ， 每 个 消息 都 会 被 投入 到 一 个 或 多 个 队列 。 

: Binding: 绑 定 ， 它 的 作用 是 把 Exchange 和 Queue 按 照 路 由 规则 绑 定 起 来 。 

: Routing Key: 路 由 关键 字 ，Exchange 根 据 这 个 关键 字 进 行 消息 投递 。 

- Vhost: 虚拟 主机 ， 一 个 Btoket 里 可 以 开设 多 个 Vhost， 用 于 不 同 用 户 的 权限 分 离 。 

RabbitMQ 概 念 二 : 

- producer: 消息 生产 者 ， 即 投递 消息 的 程序 。 

‘consumer: 消息 消费 者 ， 即 接受 消息 的 程序 。 

‘channel: 消息 通道 ， 在 客户 端的 每 个 连接 里 ， 可 建立 多 个 channel， 每 个 channel 代 表 一 个 会 话 任务 。 
RabbitMQ 架 构 如 图 5-1 所 示 。 


l RabbitMQ Server | 
| | 
| I 

[ 
| 
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Receive Message 


图 5-1 RabbitMQZ 4 


5.2 RabbitMQ 流 程 


RabbitMQ 流 程 如 下 : 

1) 客户 端 连 接 到 消息 队列 服务 器 ， 打 开 一 个 channel。 

2) 客户 端 声明 一 个 Exchange， 并 设置 相关 属性 。 

3) 客户 端 声明 一 个 Queue， 并 设置 相关 属性 。 

4) 客户 端 使 用 Routing Key， 在 Exchange 和 Queue 之 间 建 立 好 绑 定 天 系 。 
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客户 端 投 递 消息 到 Exchange。 


6) Exchange 接 收 到 消息 后 ， 就 根据 消息 的 Key 和 已 经 设置 的 Binding， 进 行 消息 路 由 ， 将 消息 投递 到 一 个 或 多 个 队列 中 。 


~~ 


下 面 先 来 安装 RabbitMQ， 在 ubuntu12.04 下 可 以 直接 通过 apt-get 安 装 : 





sudo apt-get install rabbitmq-server 





安装 好 后 ，RabbitMQ 服 务 就 已 经 启动 好 了 。 


5.2.1 单 向 发 送 消息 


下 面 介 绍 利用 Python 编 写 Hello World! 的 实例 。 实 例 的 内 容 是 从 send.py 发 送 “Hello World! ”到 RabbitMQ，receive.py 从 RabbitMQ 接 收 send.py 发 送 的 信息 。 


单 向 消息 的 结构 如 图 5-2 所 示 。 其 中 P 表 示 producer， 即 生产 者 ， 也 可 以 称 为 发 送 者 ， 实 例 中 表现 为 send.py; C 表 示 consumer， 即 消费 者 ， 也 可 以 称 为 接收 者 ， 实 例 中 表现 为 receive.py; 中 间 部 分 表 
示 队 列 ， 实 例 中 表现 为 hello 队 列 。 


hello 





H5-2 单 向 消息 


Python 使 用 RabbitMQ 服 务 ， 可 以 使 用 现成 的 类 库 ， 如 pika、txAMQP 或 者 py-amqplib， 这 里 选择 了 pika.。 
1. 安 装 pika 
pika 可 以 通过 pip 来 进行 安装 ，pip 是 Python 的 软件 管理 包 ， 如 果 没 有 安装 ， 可 以 通过 apt-get 安 装 。 


sudo apt-get install python-pip 





通过 pip 安 装 pika: 


sudo pip install pika 








2.send.py 代 码 


连接 到 RabbitMQ 服 务 器 ， 因 为 是 在 本 地 测试 ， 所 以 用 localhost 即 可 。 


connection = pika.BlockingConnection (pika.ConnectionParameters ( 
'localhost')) 
channel = connection.channel () 


声明 消息 队列 ， 消 息 将 在 这 个 队列 中 进行 传递 。 如 果 将 消息 发 送 到 不 存在 的 队列 ，RabbitM Q 将 会 自动 清除 这 些 消息 。 





channel.queue declare (queue-'hello') 
发 送 消息 到 上 面 声明 的 hello 队 列 ， 其 中 exchange 表 示 交 换 器 ， 能 精确 指定 消息 应 该 发 送 到 哪个 队列 ，routing_key 设 置 为 队列 的 名 称 ，body 就 是 发 送 的 内 容 ， 具 体 发 送 细节 暂时 先 不 关注 。 


channel.basic publish(exchange-'', routing key-'hello', body-'Hello World!") 





关闭 连接 : 


connection.close() 


完整 代码 如 下 : 


#!/usr/bin/env python 
#coding=utf8 
import pika 





connection = pika.BlockingConnection (pika.ConnectionParameters(, 'localhost') ) 
channel = connection.channel () 





channel .queue_ declare (queue-'hello') 








channel.basic publish (exchange=", routing key-'hello', body-'Hello World!') 
print " [x] Sent 'Hello World!'" i 
connection.close() 





先 来 执行 这 个 程序 ， 如 果 执 行 成 功 ，rabbitmqctl 应 该 成 功 增加 了 hello 队 列 ， 并 且 队 列 里 应 该 有 一 条 信息 ， 可 用 rabbitmqctl 命 令 来 查看 : 








rabbitmqctl list queues 


输出 信息 如 图 5-3 所 示 。 可 以 看 出 ，rabbitmqctl 中 确实 有 一 个 hello 队 列 ， 并 且 队 列 里 有 一 条 信息 。 接 下 来 用 receive.py 来 获取 队列 里 的 信息 。 


[rootücontrol 5]# rabbitmqct! l1st queues 
Listing queues ... 

hello 1 

3.receive.py 代 码 | 

和 send.py 的 前 面 两 个 步骤 一 样 ， 需 要 先 连 接 服务 器 ， 然 后 声明 消息 的 队列 。 


接收 消息 更 为 复杂 一 些 ， 需 要 定义 一 个 回调 函数 来 处 理 ， 这 里 的 回调 函数 用 于 将 信息 输出 。 





def callback(ch, method, properties, body): 


[o 


print "Received $r" $ (body,) 





告诉 RabbitMQ 使 用 callback 来 接收 信息 : 





channel.basic consume (callback, queue='hello', no ack-True) 


开始 接收 信息 ， 并 进入 阻塞 状态 ， 队 列 里 有 信息 才 会 调用 callback 进 行 处 理 。 按 Ctrl+(C 组 合 键 退 出 。 











channel.start consuming () 


完整 代码 如 下 : 





#!/usr/bin/env python 
#coding=utf8 
import pika 


connection = pika.BlockingConnection (pika.ConnectionParameters( 'localhost') ) 





channel = connection.channel () 


channel .queue declare (queue-'hello') 





def callback(ch, method, properties, body): 


print " [x] Received sr" % (body, ) 





channel.basic consume (callback, queue-'hello', no ack-True) 


print ' [*] Waiting for messages. To exit press CTRL«C' 
channel.start consuming () 





执行 程序 ， 就 能 够 接收 到 队列 hello 里 的 消息 “Hello World! " ， 然 后 输出 在 屏幕 上 。 换 一 个 终端 ， 再 次 执行 send.py， 可 以 看 到 receive.py 会 再 次 接收 到 信息 。 


5.2.2 队列 


本 节 主 要 讲述 工作 队列 (work queue) 。 


消息 也 可 以 理解 为 任务 ,消息 发 送 者 可 以 理解 为 任务 分 配 者 ,消息 接收 者 可 以 理解 为 工作 者 ， 当 工作 者 接收 到 一 个 任务 ， 且 任务 还 
现 “ 忙 不 过 来 ”的 现象 ， 于 是 就 需要 多 个 工作 者 来 共同 处 理 这 些 任务 ， 这 些 工 作者 就 称 为 工作 队列 ， 其 结构 如 图 5-4 所 示 。 





1. 准 备 工 作 (preparation) 
在 实例 程序 中 ， 用 new_task.py 来 模拟 任务 分 配 者 ， 用 worker.py 来 模拟 工作 者 。 


修改 send.py， 从 命令 行 参数 里 接收 信息 ， 并 发 送 : 


图 5-4 ”工作 队列 


a ==) 
IX ZU. 


成 的 时 候 ， 若 任务 分 配 者 又 发 一 个 任务 过 来 ， 那 工作 者 就 会 出 








import sys 








message = ' '.join(sys.argv[1:]) or "Hello World!" 
channel.basic publish(exchange-'', routing key-'hello', body=message) 
print " [x] Sent sr" $ (message, ) 





修改 receive.py 的 回调 函数 : 


import time 





def callback(ch, method, properties, body): 


print " [x] Received $r" $ (body,) 
time.sleep( body.count('.') ) 
print " [x] Done" 


new _task.py 完 整 代码 如 下 : 


#!/usr/bin/env python 
import pika 
import sys 








connection = pika.BlockingConnection (pika.ConnectionParameters ( 
host-'localhost')) 
channel = connection.channel () 





channel .queue_ declare (queue-'task queue', durable=True) 


message = ' '.join(sys.argv[1:]) or "Hello World!" 
channel.basic publish (exchange-'', 
routing key-'task queue', 
body=message, 
properties=pika.BasicProperties ( 
delivery mode = 2, # make message persistent 
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print " [x] Sent %r" $ (message,) 
connection.close() 


worker.py 完 整 代码 如 下 : 


#!/usr/bin/env python 
import pika 
import time 








connection = pika.BlockingConnection (pika.ConnectionParameters ( 
host-'localhost')) 
channel = connection.channel () 


channel.queue declare (queue-'task queue', durable-True) 
print ' [*] Waiting for messages. To exit press CTRL«C' 

















def callback(ch, method, properties, body): 


print " [x] Received $r" $ (body,) 
time.sleep( body.count('.') 
print " [x] Done" 





ch.basic ack(delivery tag - method.delivery tag) 





channel.basic gos (prefetch count=1) 
channel.basic consume (callback, queue='task queue’) 





channel.start consuming () 


先 打 开 两 个 终端 ， 都 运行 worker.py， 处 于 监听 状态 ， 就 相当 于 两 个 工作 者 。 打 开 第 三 个 终端 ， 运 行 new_task.py。 


* python new task.py First-message. 

[x] Sent 'First-message.' 

# python new task.py Second-message. 
[x] t 'Second-message.' 

# python new task.py Third-message. 








[x] Sent 'Third-message.' 

* python new task.py Fourth-message. 
[x] Sent 'Fourth-message. ' 

# python new task.py Fifth-message. 























[x] Sent 'Fifth-message.' 


观察 worker.py 接 收 到 任务 ， 其 中 一 个 工作 者 接收 到 三 个 任务 : 


# python worker.py 
[*] Waiting for messages. To exit press CTRL+C 

















[x] Received 'First-message.' 
[x] Done 
[x] Received 'Third-message.' 
[x] Done 
[x] Received 'Fifth-message.' 
[x] Done 


另外 一 个 工作 者 接收 到 两 个 任务 : 


# python worker.py 





[*] Waiting for messages. To exit press CTRI4C 
[x] Received 'Second-message.' 

[x] Done 

[x] Received 'Fourth-message.' 

[x] Done 





可 以 看 出 ， 每 个 工作 者 都 会 被 依次 分 配 到 任务 。 如 果 一 个 工作 者 在 处 理 任务 的 时 候 “ 挂 掉 ”， 这 个 任务 就 没有 完成 ， 应 当 交 由 其 他 工作 者 处 理 。 所 以 应 当 有 一 种 机 制 ， 即 当 一 个 工作 者 完成 任务 时 ， 会 


反馈 消息 。 
2. 消 息 确认 (message acknowledgment) 


消息 确认 就 是 当 工 作者 完成 任务 后 ， 会 反馈 给 RabbitMQ。 修 改 worker.py 中 的 回调 函数 : 





def callback(ch, method, properties, body): 


print " [x] Received $r" $ (body,) 
time.sleep (5) 
print " [x] Done" 





ch.basic ack(delivery tag = method.delivery tag) 


这 边 停顿 5 秒 ， 可 以 按 Ctrl+C 组 合 键 退出 。 

去 除 no_ack=True 参 数 或 者 设置 为 False 也 可 以 。 

channel.basic consume (callback, queue-'hello', no ack-False) 

运行 这 个 代码 ， 即 使 其 中 一 个 工作 者 退出 ( 按 Ctrl+C 组 合 键 ) 后 ， 正 在 执行 的 任务 也 不 会 丢失 ，RabbitM Q 会 将 任务 重新 分 配给 其 他 工作 者 。 


3. 消 息 持 久 化 存储 (message durability) 


虽然 有 了 消息 反馈 机 制 ， 但 是 如 果 RabbitMQ 自 身 挂 挤 ， 那 么 任务 还 是 会 丢失 ， 所 以 需要 将 任务 持久 化 存储 起 来 。 声 明 持久 化 人 存储: 





channel.queue declare (queue-'hello', durable-True) 


这 个 程序 会 运行 出 错 ， 因 为 hello 这 个 队列 已 经 存在 ， 并 且 是 非 持久 化 的 ，RabbitM Q 不 允许 使 用 不 同 的 参数 来 重新 定义 存在 的 队列 。 重 新 定义 一 个 队列 : 





channel.queue declare (queue-'task queue', durable-True) 


在 发 送 任务 的 时 候 ， 用 delivery_mode=2 来 标记 任务 为 持久 化 存储 : 


channel.basic publish (exchange-'', 
routing key-"task queue", 
body=message, 
properties=pika.BasicProperties ( 
delivery mode = 2, # make message persistent 








)) 


4 .公平 调 度 (fair dispatch) 


在 上 面 的 实例 中 ， 昌 然 每 个 工作 者 被 依次 分 配 到 任务 ， 但 是 每 个 任务 不 一 定 一 样 。 可 能 有 的 任务 比较 重 ， 执 行 时 间 比 较 久 ;有 的 任务 比较 轻 ， 执 行 时间 比 较 短 。 如 果 能 公平 调度 就 最 好 了 ， 使 用 
basic qos 设 置 prefetch_count=1， 使 得 RabbitM Q 不 会 在 同一 时 间 给 工作 者 分 配 多 个 任务 ， 即 只 有 工作 者 完成 任务 之 后 ， 才 会 再 次 接收 到 任务 。 





channel.basic gos (prefetch count=1) 





每 次 消息 只 会 发 送 给 其 中 一 个 接收 端 ， 如 果 需 要 将 消息 广播 出 去 ， 让 每 个 接收 端 都 能 收 到 ， 那 么 就 要 通过 区 换 实 现 。 


交换 的 工作 原理 : 消息 发 送 端 先 将 消息 发 送 给 交换 “x”， 交 换 “x” 表 将 消息 发 送 到 绑 定 的 消息 队列 ， 而 后 每 个 接收 端 都 能 从 各 自 的 消息 队列 里 接收 到 信息 ， 结 构 如 图 5-5 所 示 。 


amq.gen-RQ6... 









amq.gen-Ass... 





图 5-5 xd 


1.RabbitMQ 交 换 工 作 原 理 

下 面 用 send.py 和 和 receive.py 来 模拟 实现 交换 的 功能 。send.py 表 示 发 送 端 ，receive.py 表 示 接 收 端 。 
2.receive.py 代 码 分 析 

和 5.2.1 节 中 的 receive.py 相 比 ， 这 里 主要 做 了 两 个 改动 : 

1) 定义 交换 。 


2) 不 使 用 hello 队 列 ， 而 是 随机 生成 一 个 临时 队列 ， 并 绑 定 到 交换 “x” 上 。 


#!/usr/bin/env python 
#coding=ut £8 
import pika 


connection = pika.BlockingConnection (pika.ConnectionParameters( 'localhost') ) 














channel = connection.channel () 
RE XE nx" 
channel.exchange declare (exchange-'messages', type='fanout') 


# 随 机 生成 队列 ， 并 绑 定 到 交换 "x" 上 

result = channel.queue declare (exclusive-True) 

queue name = result.method. queue 
channel.queue bind (exchange='messages', queue-queue name) 





def callback(ch, method, properties, body): 
print " [x] Received $r" $ (body,) 


channel.basic consume (callback, queue-queue name, no ack-True) 


print ' [*] Waiting for messages. To exit press CTRL«C' 
channel.start consuming () 








在 以 上 代码 中 ，queue_declare 的 参数 exclusive=True 表 示 当 接收 端 退 出 时 ， 销 毁 临 时 产生 的 队列 ， 这 样 就 不 会 占用 资源 。 运 行 这 个 程序 ， 然 后 使 用 rabbitmqctl list exchanges 命 令 来 查看 交 
"x" 信息 ， 如 图 5-6 所 示 。 其 中 黑色 框 部 分 就 是 上 述 程序 中 定义 的 交换 "x' 了 。 使 用 rabbitmqctl list queues 查 看 消息 队列 情况 ， 如 图 5-7 所 示 。 其 中 黑色 框 部 分 就 是 随机 产生 的 消息 队列 了 。 


[rootücontrol ~]# rabbitmqct! list exchanges 
Listing exchanges ... 

amq. rabbitma. trace topic 

amq.fanout fanout 


messages -anout 


amq. topic topic 
amq. direct direct 
amq.headers headers 
amq.match headers 
. direct 
amq.rabbitma. log 





图 5-6 RabbitMQ 交 换 “x” 信 息 查 看 


[rootücontrol ~]# rabbitmqct] list queues 


Listing queues ... 
euemgen—FWCPL4/qtpHkKJkODYnPj]DO 0 





图 5-7 RabbitMQ 队 列 信息 查看 
3.send.py 代 码 分 析 
和 5.2.1 节 的 send.py 相 比 ， 这 里 只 做 了 两 个 改动 : 
1) 定义 交换 “x”。 


2) 不 是 将 消息 发 送 到 hello 队 列 ， 而 是 发 送 到 交换 “x”。 





#!/usr/bin/env python 
#coding=utf8 
import pika 





connection = pika.BlockingConnection (pika.ConnectionParameters( 'localhost')) 
channel = connection.channel () 








# 定 义 交 换 "x" 

channel.exchange declare (exchange='messages', type-'fanout') 
# 将 消息 发 送 到 交换 "x" 
channel.basic publish(exchange-'messages', routing key-'', body='Hello World!') 
print " [x] Sent 'Hello World!'" 

connection.close() 























上 述 代码 中 ，basic_publish 方 法 的 参数 exchange 被 设 定 为 相应 交换 “x“” ， 因 为 要 广播 出 去 ， 发 送 到 所 有 队列 ， 所 以 routing_key 就 不 需要 设 定 了 。 


exchange 为 空 ， 表 示 使 用 匿名 的 交换 “x”， 在 上 面 交 换 “x” 信 息 的 图 片 中 可 以 看 到 有 amq.* 这 样 的 交换 “x”， 就 是 系统 默认 的 交换 “x” 了 。routing_key 在 使 用 匿名 交换 的 时 候 才 需 要 指定 ， 表 示 
发 送 到 哪个 队列 。 


打开 另外 一 个 终端 ， 执 行 snd.py， 可 以 观察 到 receive.py 接 收 到 了 消息 。 如 果 多 个 终端 执行 了 receive.py， 那 么 每 个 receive.py 都 会 接收 到 消息 。 


每 次 消息 只 会 发 送 给 其 中 一 个 接收 端 ， 如 果 需 要 将 消息 广播 出 去 ， 让 每 个 接收 端 都 能 收 到 ， 那 么 就 要 使 用 交换 机 。 
交换 机 的 工作 原理 : 消息 发 送 端 先 将 消息 发 送 给 交换 机 ， 交 换 机 再 将 消息 发 送 到 绑 定 的 消息 队列 ， 而 后 每 个 接收 端 都 能 从 各 自 的 消息 队列 里 接收 到 信息 。 
已 经 能 实现 给 所 有 接收 端 发 送 消息 ， 但 是 如 果 需 要 自由 定制 ， 即 有 些 消 息 发 给 其 中 一 些 接收 端 ， 有 些 消息 发 送 给 另外 一 些 接收 端 ， 要 怎么 办 呢 ? 这 种 情况 下 就 要 用 到 路 由 键 了 。 


路 由 键 的 工作 原理 : 每 个 接收 端的 消息 队列 在 绑 定 交换 机 的 时 候 ， 可 以 设 定 相应 的 路 由 键 。 发 送 端 通过 交换 机 发 送信 息 时 ， 可 以 指明 路 由 键 ， 交 换 机 会 根据 路 由 键 把 消息 发 送 到 相应 的 消息 队列 ， 这 样 
接收 端 就 能 接收 到 消息 了 。 


下 面 用 send.py 和 receive.py 来 模拟 实现 路 由 键 的 功能 。send.py 表 示 发 送 端 ，receive.py 表 示 接 收 端 。 实 例 的 功能 是 将 info、warning、error 三 种 级 别 的 信息 发 送 到 不 同 的 接收 端 ， 如 图 5-8 所 示 。 


amqp.gen-S9b... 





amqp.gen-Agl... 








type-direct ^ 









CITOLI 





warning 


图 5-8 ”路 由 模式 


1.send.py 代 码 分 析 
和 5.2.3 节 相 比 ， 改 动 点 主要 有 两 个 方面 。 
1) 设 定 交换 机 的 类 型 (type) 为 direct。5.2.3 节 将 交换 机 的 类 型 设置 为 fanout， 表 示 广 播 ， 会 将 消息 发 送 到 所 有 接收 端 ; 这 里 设置 为 direct， 表 示 要 根据 设 定 的 路 由 键 来 发 送 消息 。 


2) 发 送信 息 时 设置 发 送 的 路 由 键 。 


#!/usr/bin/env python 
#coding=utf8 
import pika 





connection = pika.BlockingConnection (pika.ConnectionParameters ( 
'localhost')) 
channel = connection.channel () 


# 定 义 交 换 机 ， 设 置 类 型 为 direct 


channel.exchange declare (exchange-'messages', type-'direct') 


# 定 义 三 个 路 由 键 
routings = ['info', 'warning', 'error'] 
FUR B He RE BEA OIL, 并 设置 路 由 刍 
for routing in routings: 
message = '$s message.' $ routing 
channel RM pec M e 
routing key-routing, 
body=message) 




















print message 


connection.close () 


2.receive.py 代 码 分 析 
和 5.2.3 节 相 比 ， 改 动 点 主要 有 三 个 方面 。 
) 设 定 交 换 机 的 类 型 (type) 为 direct。 
2) 增加 命令 行 获取 参数 功能 ， 参 数 即 为 路 由 键 。 


3) 将 队列 绑 定 到 交换 机 上 时 ， 设 定 路 由 键 。 


#!/usr/bin/env python 
#coding=utf8 
import pika, sys 





connection = pika.BlockingConnection (pika.ConnectionParameters ( 
'localhost')) 

channel = connection.channel () 

# 定 义 交 换 机 ， 设 置 类 型 为 direct 

channel.exchange declare (exchange='messages', type-'direct') 

# 从 命令 行 获取 路 由 键 参 数 ， 如 果 没 有 ， 则 设置 为 info 


routings = sys.argv[1:] 


























if not EE 
outings = ['info' 
# 生 成 临时 队列 ， 并 绑 定 到 交换 机 上 ， 设 置 路 由 键 
result = channel.queue declare (exclusive-True) 





queue name = result.method.queue 
for routing in routings: 
channel.queue bind(exchange-'messages', 
queue-queue name, 
routing key-routing) 





def callback(ch, method, properties, body): 


print " [x] Received $r" $ (body,) 


channel.basic consume (callback, queue-queue name, no ack-True) 








print ' [*] Waiting for messages. To exit press CTRL«C' 
channel.start consuming () 


打开 两 个 终端 : 一 个 终端 运行 代码 python receive.py info warning， 表 示 只 接收 info 和 warning 的 消息 ; 另 一 个 终端 运行 snd.py， 可 以 观察 到 接收 终端 只 接收 到 了 info 和 warning 的 消息 。 如 果 打 开 
多 个 终端 运行 receive.py， 并 传 入 不 同 的 路 由 键 参数 ， 可 以 看 到 更 明显 的 效果 。 


当 接 收 端 正在 运行 时 ， 可 以 使 用 rabbitmqctl list bindings 来 查看 绑 定 情况 。 
3. 错 误 分 析 


可 能 会 出 现 如 下 的 错误 : 








python receive.py info warning 
Traceback (most recent call last): 
File "receive.py", line 9, in «module» 
channel.exchange declare (exchange-'messages', type-'direct') 
File "/usr/lib/python2.7/site-packages/pika/adapters/blocking connection.py", line 2207, in exchange declare 
self. flush output(declare ok result.is ready) 
File "/usr/lib/python2.7/site-packages/pika/adapters/blocking connection.py", line 1181, in flush output 
raise exceptions.ChannelClosed (method.reply code, method.reply text) 
pika.exceptions.ChannelClosed: (406, "PRECONDITION FAILED - inequivalent arg 'type' for exchange 'messages' in vhost '/': received 'direct' but current is 'fanout'") 



















































































原因 分 析 : 队列 中 已 经 存在 messages， 如 果 再 次 运行 就 会 报 Exchange 已 经 存在 的 消息 。 








# rabbitmqctl stop app 

Stopping node rabbit@control http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
# 

S 





























rabbitmqctl start app 
























































tarting node rabbit@control http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 











执行 上 述 命令 后 即 可 正常 运行 。 


5.2.5 ”主题 


通过 设置 路 由 键 ， 可 以 将 消息 发 送 到 相应 的 队列 ， 这 里 的 路 由 键 要 完全 匹配 ， 例 如 ，info 消 息 只 能 发 到 路 由 键 为 info 的 消息 队列 。 
路 由 键 模糊 匹配 ， 可 以 使 用 正则 表达 式 实现 。 和 常用 的 正则 表示 式 不 同 ， 这 里 “#” 表示 所 有 、 全 部 的 意思 ，“”*” 只 匹配 到 一 个 词 。 


下 面 用 send.py 和 receive.pPy 来 实现 路 由 键 模糊 匹配 的 功能 。send.pPy 表 示 发 送 端 ，receive.py 表 示 接 收 端 。 实 例 的 功能 大 概 是 这 样 : 比如 你 有 一 些 知心 好 朋友 ， 不 管 开心 、 伤 心 、 工 作 上 、 人 生活 上 的 事情 
都 可 以 和 他 们 说 ;还 有 一 些 朋 友 ， 你 可 以 跟 他 们 分 享 开心 的 事情 ; 还 有 一 些 朋 友 ， 你 可 以 把 不 开心 的 事情 和 他 们 说 ， 如 图 5-9 所 示 。 


QI 


siz : 3 
; orange. 
type-topic -一 一 ELL 


X * . * rabbit Q2 


图 5-9 ”主题 模式 









1.send.py 代 码 分 析 


因为 要 进行 路 由 键 模糊 匹配 ， 所 以 交换 机 的 类 型 要 设置 为 topic， 可 以 使 用 匹配 符号 #、*。 





#!/usr/bin/env python 
#coding=utf8 
import pika 








connection = pika.BlockingConnection (pika.ConnectionParameters ( 
'localhost')) 
channel = connection.channel () 


定义 交换 机 ， 设 置 类 型 为 Lopic 
channel.exchange declare (exchange-'messages', type-'topic') 


定义 路 由 键 
routings = ['happy.work', 'happy.life', 'sad.work', 'sad.life'] 


# 将 消息 依次 发 送 到 交换 机 ， 并 设 定 路 由 键 
for routing in routings: 
message = '$s message.' $ routing 
channel.basic publish (exchange-'messages', 
routing key-routing, 
body=message) 










































































print message 


connection.close () 





上 述 程序 中 定义 了 四 种 类 型 的 消息 ， 然 后 依次 将 它们 发 送出 去 。 
2.receive.py 代 码 分 析 


交换 机 的 类 型 设 定 为 topic。 对 命令 行 接收 参数 的 功能 稍微 进行 调整 ， 即 没有 参数 时 会 报错 退出 。 





#!/usr/bin/env python 
#coding=utf8 
import pika, sys 








connection = pika.BlockingConnection (pika.ConnectionParameters ( 
'localhost')) 
channel = connection.channel () 


# 定 义 交 换 机 ， 设 置 类 型 为 topic 
channel.exchange declare (exchange-'messages', type-'topic') 


# 从 命令 行 获取 路 由 参数 ， 如 果 没 有 ， 则 报错 退出 
routings = sys.argv[1:] 
if not routings: 
print >> sys.stderr, "Usage: $s [routing key]http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/..." $ (sys.argv[0],) 



























































exit () 


# 生 成 临时 队列 ， 并 绑 定 到 交换 机 上 ， 设 置 路 由 键 
result = channel.queue declare (exclusive-True) 
queue name = result.method.queue 
for routing in routings: 
channel.queue bind(exchange-'messages', 
queue-queue name, 
routing key-routing) 












































def callback(ch, method, properties, body): 


o 


print " [x] Received $r" $ (body,) 





channel.basic consume (callback, queue-queue name, no ack-True) 








print ' [*] Waiting for messages. To exit press CTRL«C' 
channel.start consuming () 





打开 四 个 终端 ， 第 一 个 终端 运行 如 下 ， 表 示 任 何事 情 都 可 以 和 他 们 说 : 


python receive.py "#" 


第 二 个 终端 运行 如 下 ， 表 示 可 以 和 他 们 分 享 开心 的 事 : 


python receive.py "happy.*" 





第 三 个 终端 运行 如 下 ， 表 示 工 作 上 的 事情 可 以 和 他 们 分 享 : 


python receive.py "*.work" 


最 后 一 个 终端 运行 python send.py。 结 果 可 以 自己 分 析 一 下 ， 然 后 与 程序 的 输出 进行 比较 ， 观 察 两 者 是 否 一 致 。 

Q 

"ad^ de "au" ERN]: 

1) *-F “aH” , RRR REPAY Ai Za TAT, dea. ahaha, ahahahaha. 而 如 abs、abc、abc.haha 这 样 的 词 是 不 合法 的 。 


2) MF "aH" IB Lath FA BAT, dea. ahaha, ahahahaha. sg54waiUR 89458 RAIA. 


5.2.6 RPCialFA 


前 面 的 例子 都 有 一 个 共同 点 ， 即 发 送 端 发 送 消息 后 没有 结果 返回 。 如 果 只 是 单纯 发 送 消息 ， 这 是 没有 不 妥 的 ， 但 是 在 实际 中 ， 常 常会 需要 接收 端 将 收 到 的 消息 进行 处 理 之 后 ， 返 回 给 发 送 端 。 


处 理 方法 描述 : 发 送 端 在 发 送信 息 前 ， 产 生 一 个 接收 消息 的 临时 队列 ， 该 队列 用 来 接收 返回 的 结果 。 其 实在 这 里 接收 端 、 发 送 端的 概念 已 经 比较 模糊 了 ， 因 为 发 送 端 同样 要 接收 消息 ， 接 收 端 同样 要 发 
送 消息 ， 所 以 这 里 笔者 使 用 另外 的 示例 来 演示 这 一 过 程 ， 如 图 5-10 所 示 。 


rpc queue 


Request 
- reply to-amqp.gen-Xa2... » | 
Client | ; s ~ Server 
| correlation 1d—abc 


reply to-amq.gen-Xa2... 


A 
Reply 
correlation. 1d—abc 


EK5-10 RPCHEX, 





示例 内 容 : 假设 有 一 个 控制 中 心 和 一 个 计算 节点 ， 控 制 中 心 会 将 一 个 自然 数 N 发 送 给 计算 节点 ， 计 算 节 点 将 N 值 加 1 后 ， 返 回 给 控制 中 心 。 这 里 用 center.py 模 拟 控制 中 心 ， 用 compute.py 模 拟 计算 节 


1. 增 加 结果 返回 


(1) compute-A.py 代 码 分 析 


#!/usr/bin/env python 
#coding=utf8 
import pika 


# 连 接 RalbbitMO 服 务 器 

connection = pika.BlockingConnection (pika.ConnectionParameters ( 
host='localhost') ) 

channel = connection.channel () 


# 定 义 队列 
channel.queue | poole ae conn queue") 
print ' [*] Waiting for n' 


TÉ T. 
def increase (n): 
return n+ 1 


# 定 义 接收 到 消息 的 处 理 方法 
def request(ch, method, properties, body): 


print " [.] increase($s)" % (body,) 






































response - increase (int (body)) 


# 将 计算 结果 发 送 回 控制 中 心 

ch.basic publish (exchange='', 
routing key-properties.reply to, 
body=str (response)) 

ch.basic ack(delivery tag = method.delivery tag) 



































channel.basic qos (prefetch count=1) 
channel.basic consume (request, queue-'compute queue!) 





channel.start consuming () 


计算 节点 的 代码 比较 简单 ， 值 得 一 提 的 是 ， 原 来 的 接收 方法 都 是 直接 将 消息 打印 出 来 ， 这 边 进行 了 加 1 的 计算 ， 并 将 结果 发 送 回 控制 中 心 。 


(2) center-A.py 代 码 分 析 


#!/usr/bin/env python 
#coding=ut £8 
import pika 











class Center (object): 

def init (self): 
self.connection = pika.BlockingConnection (pika.ConnectionParameters ( 
host-'localhost')) 


— 














— 
. 





























self.channel = self.connection.channel () 


# 定 义 接收 返回 消息 的 队列 
result = self.channel.queue declare (exclusive-True) 
self.callback queue - result.method.queue 



































self.channel.basic consume (self.on response, 
no ack-True, 
queue-self.callback queue) 























# 定 义 接 收 到 返回 消息 的 处 理 方法 
def on | response (self, ch, method, props, body): 
self.response - body 

















def r s Dt. mis 
.response = None 
4 发 送 计算 请 求 并 声明 返回 队列 
self.channel.basic publish (exchange='', 
routing key-'compute queue', 
properties-pika.BasicProperties( 
reply to = self.callback queue, 
); 
body=str (n) ) 






























































# 接 收 返回 的 数据 

while self.response is None: 
self.connection.process data events () 

return int (self.response) 























center = Center () 














print " [x] Requesting increase (30)" 
response = center.request (30) 
print " [.] Got $r" % (response, ) 





述 代 码 定义 了 接收 返回 数据 的 队列 和 处 理 方法 ， 并 且 在 发 送 请 求 的 时 候 将 该 队列 赋值 给 reply_ to， 在 计算 节点 代码 中 就 是 通过 这 个 参数 来 获取 返回 队列 的 。 
打开 两 个 终端 ， 一 个 终端 运行 代码 compute-A.py， 另 一 个 终端 运行 center-A.py， 如 果 执 行 成 功 ， 就 能 看 到 效果 了 。 
2. 带 correlation id 返回 


假设 有 多 个 计算 节点 ， 控 制 中 心 开 启 多 个 线程 ， 向 这 些 计 算 节点 发 送 数字 ， 要 求 计 算 结果 并 返回 ， 但 是 控制 中 心 只 开启 了 一 个 队列 ， 所 有 线程 均 从 这 个 队列 获取 消息 ， 每 个 线程 如 何 确定 收 到 的 消息 就 
是 该 线程 对 应 的 消息 呢 ? 这 个 就 要 提 到 correlation id 的 用 处 了 。 


correlation id 运行 原理 : 控制 中 心 发 送 计算 请 求 时 设置 Correlation id， 而 后 计算 节点 将 计算 结果 ， 连 同 接收 到 的 correlation id 一 起 返回 ， 这 样 控制 中 心 就 能 通过 correlation id 来 标识 请 求 。 其 实 
correlation id 也 可 以 理解 为 请 求 的 唯一 标识 码 。 


示例 内 容 : 控制 中 心 开 启 多 个 线程 ， 每 个 线程 都 发 起 一 次 计算 请 求 ， 通 过 correlation id， 每 个 线程 都 能 准确 收 到 相应 的 计算 结果 。 
(1) compute-B.py 代 码 分 析 


和 compute-A.py 相 比 ， 这 里 只 需 修改 一 个 地 方 : 将 计算 结果 发 送 回 控制 中 心 时 ， 增 加 参数 correlation_id 的 设 定 ， 该 参数 的 值 其 实 是 从 控制 中 心 发 送 过 来 的 ， 这 里 只 是 再 次 发 送 回去 。 代 码 如 下 : 


#!/usr/bin/env python 
fcoding-utf8 
import pika 








# 连 接 RabbitMO 服 务 器 

connection = pika.BlockingConnection (pika.ConnectionParameters ( 
host='localhost') ) 

channel = connection.channel () 


# 定 义 队 列 
channel.queue d produces Comte queue') 
print ' [*] Waiting for n' 


# 将 n 值 加 1 
def increase (n): 
return n+ 1 


# 定 义 接收 到 消息 的 处 理 方法 
def request (ch, method, props, body): 


9 


print " [.] increase($s)" % (body,) 





























response = increase (int (body)) 




















# 将 计算 结果 发 送 回 控制 中 心 ， 增 加 correlation ig 的 设 定 

ch.basic publish (exchange-'', 
routing key=props.reply to, 
properties-pika.BasicProperties (correlation id = \ 
props.correlation id), 
body-str (response) ) 

ch.basic ack(delivery tag = method.delivery tag) 























channel.basic gos (prefetch count=1) 
channel.basic consume (request, queue-'compute queue') 





channel.start consuming () 


(2) center-B.py 代 码 分 析 


空 制 中 心 代码 稍微 复杂 些 ， 其 中 比较 关键 的 有 三 个 地 方 : 


1) 使 用 Python 的 uuid 来 产生 唯一 的 correlation id, 
2) 发 送 计算 请 求 时 ， 设 定 参数 correlation_id。 
3) 定义 一 个 字典 来 保存 返回 的 数据 ， 并 且 键 值 为 相应 线程 产生 的 correlation_id。 


代码 如 下 : 





#!/usr/bin/env python 
#coding=utf8 
import pika, threading, uuid 





# 自 定义 线程 类 ， 继 承 threading.Thread 
class MyThread (threading.Thread): 
def init (self, func, num): 
super(MyThread, self). init () 
self.func = func 
self.num = num 


















































def run(self): 


— 


























print " [x] Requesting increase($d)" $ self.num 
response - self.func(self.num) 
print " [.] increase($d)-$d" $ (self.num, response) 





# 控 制 中 心 类 
class Center (object): 
def init (self): 
self.connection = pika.BlockingConnection (pika.ConnectionParameters ( 
host-'localhost')) 



































self.channel = self.connection.channel () 


# 定 义 接收 返回 消息 的 队列 
result = self.channel.queue declare (exclusive-True) 
self.callback queue - result.method.queue 


























self.channel.basic consume (self.on response, 
no ack-True, 
queue-self.callback queue) 


# 返 回 的 结果 都 会 存储 在 该 字典 里 


self.response = {} 


# 定 义 接 收 到 返回 消息 的 处 理 方法 
def on response(self, ch, method, props, body): 
self.response[props.correlation id] = body 
































def request(self, n): 
corr id = str(uuid.uuid4()) 
self.response[corr id] - None 


# 发 送 计 算 请 求 ， 并 设 定 返 回 队列 和 correlation id 
self.channel.basic publish (exchange='', 
routing key-'compute queue', 
properties-pika.BasicProperties( 
reply to = self.callback queue, 
correlation id = corr id, 
), 
body-str (n)) 












































# 接 收 返 回 的 数据 

while self.response[corr id] is None: 
self.connection.process data events () 

return int(self.response[corr id]) 

















center = Center () 

# 发 起 5 次 计算 请 求 

nums- [10, 20, 30, 40 ,50] 

threads = [] 

for num in nums: 

threads.append (MyThread(center.request, num)) 
or thread in threads: 

thread.start () 

or thread in threads: 

thread.join() 























开启 两 个 终端 ， 一 个 终端 用 来 运行 compute-B.py， 另 一 个 终端 用 来 运行 center-B.py， 输 出 结果 如 图 5-11 所 示 。 


[rootücontrol 5.2.6]# python center-B.py 
[x] Requesting increase(10) 

[x] Requesting increase(20) 

[x] Requesting increase(30) 

[x] Reguesting increase(40) 

[.] increase(30)=31 


[.] increase(20)=?1 
[.] increase(40)=41 

[.] increase(10)-11 
[x] Requesting increase(50) 
[.] increase(50)-51 





图 5-11 RabbitMQ 多 节点 结果 返回 


可 以 看 到 ， 虽 然 获取 的 结果 不 是 顺序 输出 ， 但 是 结果 和 原 数 据 都 是 对 应 的 。 


这 个 示例 的 做 法 就 是 创建 一 个 队列 ， 使 用 correlation id 来 标识 每 次 请 求 。 也 有 的 做 法 是 不 使 用 correlation id， 即 每 请 求 一 次 ， 就 创建 一 个 临时 队列 ， 不 过 这 样 性 能 消耗 比较 大 ， 不 推荐 这 么 做 。 
RabbitMQ Exchange 如 下 : 

: Fanout Exchange (不 处 理 路 由 键 ) 。 

Direct Exchange (处 理 路 由 键 ) 。 

: Topic Exchange. (将 路 由 键 和 某 模 式 进行 匹配 ) 。 


Topic Exchange (主题 交换 ) 如 图 5-12 所 示 。 


Topic Exchange 














Messages: | routing key= | | routing key= routing key= routing key= 
| usa.news usa.weather europe.news europe.weather 


Broker 


Exchange: 


Bindings: 


binding key= $ Binding 


s: | | binding key= binding key- 
usa.# ars] | #weather | (Res: 





图 5-12 Topic Exchange 


5.3 RabbitMQ 持 久 化 


1) Exchange 持 久 化 ， 在 声明 时 指定 durable>1。 
2) Queue 持 久 化 ， 在 声明 时 指定 durable>1。 
3) 消息 持久 化 ， 在 投递 时 指定 delivery mode>2 (1 是 非 持久 化 ) 。 


/var/lib/rabbitmq/mnesia/rabbit @ $(hostname)/msg store_persistent 目 录 下 产生 持久 化 消息 数据 。 在 运行 consumer 程 序 后 ， 这 些 数 据 都 会 消失 。 


5.4 本章 小 结 


本 章 主要 讲解 了 RabbitMQ 的 相关 概念 及 Python 的 代码 实现 。 


S66 DevStack 


本 章 主要 讲述 使 用 DevStack 搭 建 单机 版 的 OpenStack 环 境 。 为 了 方便 大 家 学 习 ， 本 次 DevStack 部 署 使 用 VMware 虚拟 机 ， 有 条 件 的 可 以 使 用 物理 机 。 主 机 操作 系统 为 Win7，VMware 版 本 为 
11.1，Linux 操 作 系 统 为 CentOS7.1。 


6.1 DevStack 介 绍 


DevStack 是 每 个 OpenStack 开 发 者 必 备 的 工具 ， 通 过 DevStack 能 够 快速 部 署 指定 版 本 的 OpenStack。 以 前 OpenStack 的 整个 安装 过 程 受 限于 各 种 网 络 环境 ， 整 个 部 署 过 程 比 较 耗 时 ， 很 难 一 次 快速 安 
装 完成 ， 总 会 出 现 各 种 各 样 的 问题 ， 一 方面 Openstack 部 署 复杂 性 确实 比较 高 ， 另 一 方面 网 络 经 常 出 问题 ， 往 往 很 多 依赖 包 下 载 超时 。Openstack 版 本 (Mitaka) 的 整个 部 署 过 程 相对 比较 顺利 ， 可 以 看 
出 随 着 国内 近 几 年 有 越 来 越 多 的 企业 、 工 程 师 使 用 Openstack， 其 在 国内 的 发 展 异常 迅猛 。 


6.2 ”操作 系统 的 安 委 与 配置 


本 节 内 容 主要 讲述 硬件 的 配置 、 操 作 系统 的 安装 及 安装 后 的 配置 。 


6.2/1 _ VMware 虚拟 机 的 配置 


di 


下 面 以 在 一 台 VMware 虚 拟 机 进行 DevSstack 部 署 为 例 介绍 VMware 虚拟 机 的 配置 。 具 体 的 配置 如 下 : 2 核 CPU、4GB 内 存 、40GB 磁 盘 空间 、 三 块 网 卡 ， 操 作 系统 为 CentOS7.1， 硬 件 配置 如 图 6-1 所 
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图 6-1 虚拟 机 硬件 配置 


oor 


VMware Workstation $7 J& AA 11.1.0build-2496824. 


虚拟 网 络 编辑 器 的 配置 如 图 6-2 所 示 。 
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图 6-2 ”虚拟 网 络 编辑 器 的 配置 


VMware Network Adapter VMware Network Adapter 
VMnetl VMnet8 
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Microsoft Loopback Adapter #2 


图 6-3 Win7 操 作 系 统 的 网 络 配置 


使 用 的 iSO 镜 像 的 版 本 为 CentOS-7-x86_64-Minimal-1503-01.iso， 安 装 时 保持 默认 设置 ， 安 装 过 程 可 参考 相关 材料 ， 这 里 不 再 歼 述 。 


6.2.2 ”系统 配置 
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1. 网 络 配置 


在 安装 完成 之 后 ， 虚 拟 机 的 第 一 块 网 卡 用 来 做 管理 网 和 外 网 ， 配 置 如 图 6-4 所 示 。 


[root@control network-scripts]£ cat ifcfg-eno16777736 
TYPE-Ethernet 

BOOTPROTO=static 

DEFROUTE=yes 

IPV4_FAILURE_FATAL=no 


NAME=enol6/7//7736 
DEVICE=enol67777 36 
ONBOOT=yes 
IPADDR=192.168.0.50 
PREFIX224 





图 6-4 Linux 第 一 块 网 卡 的 配置 


虚拟 机 的 第 二 块 网 卡 用 于 部 署 ， 配 置 如 图 6-5 所 示 。 


[root@control network-scripts]# cat ifcfg-eno33554960 
TYPE=Ethernet 
BOOTPROTO=static 
DEFROUTE=yes 
PEERDNS=yes 
PEERROUTES=yes 
IPV4_FAILURE_FATAL=no 
IPV6INIT=yes 
IPV6_AUTOCONF=yes 
IPV6_DEFROUTE=yes 
IPV6_PEERDNS=yes 
IPV6_PEERROUTES=yes 
IPV6_FAILURE_FATAL=no 
NAME=eno33554960 
DEVICE-eno33554960 
ONBOOT-yes 
IPADDR=10.20.0.50 
NETMASK=255.255.255.0 





图 6-5 Linux -H WF 85 Bo X 


虚拟 机 的 第 三 块 网 卡 用 来 联网 ， 配 置 如 图 6-6 所 示 。 


[root@control network-scripts]£ cat ifcfg-eno50332184 
TYPE-Ethernet 
BOOTPROTO=dhcp 
DEFROUTE=yes 
PEERDNS=yes 
PEERROUTES=yes 
IPV4_FAILURE_FATAL=no 
IPV6INIT-yes 

IPV6, AUTOCONF-yes 
IPV6_DEFROUTE=yes 
IPV6_PEERDNS=yes 
IPV6_PEERROUTES=yes 
IPV6_FAILURE_FATAL=no 
NAMEzeno50332184 
DEVICE-eno50332184 
ONBOOT-yes 





图 6-6 ”Linux 第 三 块 网 卡 的 配置 


Win7 主 机 系统 的 第 一 块 回环 网 卡 的 配置 如 图 6-7 所 示 。 


Win7 主 机 系统 的 第 二 块 回环 网 卡 的 配置 如 图 6-8 所 示 。 





网 第 妹 接手 和 信息 UD : 


种 接 特定 的 DNS 后 名 
TELE 

EHO 

已 启用 DHCP 


IFw4 FPA 
IPv4 Zhe 
IFw4 DNS 服务 器 


IPv4 WINS BRE 
EFA HetBIDS ave... 
主 控 -本 吉 IPS GHI 
TF Ships 

IP«& DNS IRES 





IB 


Microsoft Loopback Adapter 
Ue-U0-4C-4F-4F-S0 


-T= 
H 


fod. foo. 2o. U 


E 
AE 


teg: :3aT1:Tlod:1£28:8abi*23 


E£ecll:U:: £££EE: : 181 
Eaecll:U:: EEEE: :z X1 
fecll:U:: ££EE: : 3*1 





图 6-7 Win7 第 一 块 回环 网 卡 的 配置 
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Win7 主 机 同 虚 拟 机 的 网 络 连通 性 测试 如 图 6-9 所 示 。 
使 用 SecureCRT SSH 远 程 连接 Linux 虚 拟 机 ， 如 图 6-10 所 示 。 


er 


也 可 以 使 用 其 他 远程 连接 工具 ， 这 样 方便 管理 Linux 虚 拟 机 。 
2. 系 统 配置 
1) 关闭 selinux， 如 图 6-11 所 示 。 


2) 闭关 并 停止 firewalld， 命 令 如 下 : 





systemctl stop firewalld 
systemctl disable firewalld 
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图 6-8 Win7 第 二 块 回环 网 卡 的 配置 
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图 6-9 ”网 络 连通 性 测试 


w 192.168.0.50 x 





Last login: wed Oct 12 01:00:01 2016 Trom 192.168. D. 200 
[root@control ~|# 


图 6-10 SSH 远 程 连接 虚拟 机 
[root&control ~]# cat /etc/selinux/config 


# This file controls the state of SELinux on the system. 
# SELINUX- can take one of these three values: 


= enforcing - SELinux security policy is enforced. 
= permissive - SELinux prints warnings instead of enforcing. 
= disabled - No SELinux policy is loaded. 


SELINUX-disabled 
# SELINUXTYPE- can take one of three two values: 


= targeted - Target ey, processes are protected, 
= minimum - Modification of targeted policy. only selected processes are protected. 
= mls - Multi Level Security protection. 


SELINUXTYPE=tar geted 


图 6-11 关闭 selinux 
3) 防火 墙 的 配置 。 添 加 80、6080 两 个 端口 ， 如 图 6-12 所 示 。 


[root&control ~]# cat /etc/sysconfig/iptables 

# sample configuration for iptables service 

# you can edit this manually or use system-config-firewal]l 

# please do not ask us to add additional ports/services to this default configuration 
*f1lter 

:INPUT ACCEPT [0:0] 

“FORWARD ACCEPT [0:0] 

“OUTPUT ACCEPT [0:0] 

-A INPUT -m State --STate@ RELATED,ESTABLISHED -j ACCEPT 

-A INPUT -p icmp -j ACCEPT 

-A INPUT -1 lo -j ACCEPT 

-A INPUT -p tcp -m state --state NEW -m tcp --dport 22 -] ACCEPT 
-A INPUT -p tcp -m state --state NEW -m tcp --dport 80 -] ACCEPT 
-A INPUT -p tcp -m state --state NEW -m tcp --dport 6080 -j ACCEPT 
-A INPUT -j]j REJECT --reject-with icmp-host-prohibited 

-A FORWARD -j REJECT --reject-with icmp-host-prohibited 

COMMIT 


图 6-12 防火墙 的 配置 


修改 完 之 后 要 重 局 iptables 防 火 墙 。 


oor 


无 论 是 虚拟 机 还 是 物理 机 ， 内 存 容 量 要 求 在 2GB 以 上 ， 和 否则 用 虚拟 机 部 署 “alin one ”会 遇 到 内 存 资 源 不 足 的 情况 ， 导 致 很 多 组 件 运行 出 错 。 


6.3 ”环境 准备 与 配置 


6.3.1 ”DevStack) 准 备 


1) 安装 Git: 


yum install git -y 





2) 下 载 代 码 : 


mkdir /opt/devstack 





使 用 Git 下 载 DevStack 的 代码 时 需要 注意 版 本 的 选择 ， 打 开 DevStack 的 代码 地 址 ， 查 看 一 下 分 支 情况 ， 如 图 6-13 所 示 。 


Switch branches/tags X 





Branches Tags 


w^ master 
stable/kilo 
stable/liberty 


stable/mitaka 


stable/newton 





stable/ocata 





图 6-13 分支 列表 


Os 


Ocata 目 前 是 最 新 版 ，2017 年 2 月 22 号 发 布 。 
我 们 下 载 的 是 Mitaka 的 版 本 ,命令 如 下 : 


git clone https://github.com/openstack-dev/devstack.git/opt/devstack -b stable/newton 


oor 


gt 命令 可 以 参考 2.5 节 的 内 容 ，-b 是 复制 分 支 ，Stable 是 稳定 版 本 ， 如 果 不 指定 分 支 默 认 是 Master 分 支 。 指 定 Mitaka 后 ， 部 署 出 来 的 OpenStack 版 本 默认 是 Mitaka。 
3) 用 户 及 权限 : 


cd /opt/devstack 


./tools/create-stack-user.sh 
chown -R stack.stack http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/0EBPS/Text/../devstack/ 


Su - stack 


6.3 ”环境 / 佳 备 与 配置 


6.3.1 DevStack) 准 备 
1) 安装 Git: 
yum install git -y 
2) 下 载 代码 : 
mkdir /opt/devstack 


使 用 Git 下 载 DevStack 的 代码 时 需要 注意 版 本 的 选择 ， 打 开 Devstack 的 代码 地 址 ， 查 看 一 下 分 支 情况 ， 如 图 6-13 所 示 。 


Switch branches/tags T. | 





Branches Tags | 


w^ master 
stable/kilo 
stable/liberty 


stable/mitaka 





stable/newton 





stable/ocata 





图 6-13 分支 列 表 


oir 


Ocata 目 前 是 最 新 版 ，2017 年 2 月 22 号 发 布 。 


我 们 下 载 的 是 Mitaka 的 版 本 ， 命 令 如 下 : 





git clone https://github.com/openstack-dev/devstack.git/opt/devstack -b stable/newton 


oor 


git 命 令 可 以 参考 2.5 节 的 内 容 ，-b 是 复制 分 支 ，Stable 是 稳定 版 本 ， 如 果 不 指定 分 支 默 认 是 Mastet 分 支 。 指 定 Mitaka 后 ， 部 署 出 来 的 OpenStack 版 本 默认 是 Mitaka。 


3) 用 户 及 权限 : 








cd /opt/devstack 


./tools/create-stack-user.sh 
chown -R stack.stack http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/0EBPS/Text/../devstack/ 


Su - stack 
































6.3.2 ”配置 local.conf 文 件 


配置 文件 local.conf 的 来 源 ， 如 图 6-14 所 示 。 


[stack@control devstack]$ cp samples/local.conf local.conf 
[stackücontrol devstack]$ pwd 
/opt/devstack 


图 6-14 ”生成 配置 文件 


配置 文件 需要 根据 网 络 情况 进行 修改 ， 下 面 逐一 介绍 。 


1) 添加 国内 的 Git 源 : 





# use TryStack git mirror 
GIT BASE=http://git.trystack.cn 


NOVNC REPO-http://git.trystack.cn/kanaka/noVNC.git 


SPICE REPO-http://git.trystack.cn/git/spice/spice-html5.git 



























































2) 网 络 使 用 Neutron : 





disable service n-net 
enable service q-svc 
enable service q-agt 
enable service q-dhcp 
enable service q-13 
enable service q-meta 














oor 


默认 的 local.conf 使 用 NovaNetwotk， 如 果 带 开发 者 不 需要 Neutton， 可 以 不 添加 Neutton。 


3) 配置 外 网 : 


## Neutron options 
Q USE SECGROUP=True 


FLOATING RANGE="192.168.0.0/24" 
#FIXED RANGE="10.0.1.0/24" 

Q FLOATING ALLOCATION POOL=start=192.168.0.250,end=192.168.0.254 
PUBLIC NETWORK GATEWAY="192.168.0.200" 


PUBLIC_INTERFACE=eno16777736 
















































































# Open vSwitch provider networking configuration 
Q USE PROVIDERNET FOR PUBLIC=True 

OVS PHYSICAL BRIDGE=br-ex 

PUBLIC BRIDGE=br-ex 

OVS BRIDGE MAPPINGS-public:br-ex 



















































































4) 配置 主机 和 密码 : 





HOST IP-10.20.0.50 





ADMIN PASSWORD-123456 

DATABASE PASSWORD-stackdb 

RABBIT PASSWORD-stackqueue 

SERVICE PASSWORD-S$ADMIN PASSWORD 












































6.4 ”安装 DevStack 


在 编辑 好 |local.conf 后 ， 就 可 以 执行 stack.sh 进 行 DevStack 的 安装 了 。 





#./stack.sh 
根据 配置 和 网 络 情况 ， 部 署 会 需要 5 ~ 6 小 时 ， 可 以 提前 使 用 Git 命 令 把 相关 组 件 的 源码 下 载 到 相关 的 目录 ， 会 降低 部 署 时 间 及 出 错 的 概率 。 


成 功 部 署 完 成 之 后 ， 会 出 现 如 图 6-15 所 示 的 提示 信息 。 


DevStack Components Timed 


run process 一 85 secs 

pip install - 468 secs 

restart apache server - 13 secs 
wait for service 一 69 secs 

yum install - 195 secs 


This 15 your host IP address: 10.20.0.50 

This 15 your host IPv6 address: ::1 

Horizon 1s now available at http: //10. 20.0. 50/dashboard 
Keystone 15 serving at http: //10. 20.0. 50:5000/ 

The default users are: admin and demo 

The password: 123456 


图 6-15 ”成功 部 署 后 的 提示 


oor 


到 这 里 可 以 创建 一 个 快照 ， 否 则 每 次 关机 重启 后 ， 都 需要 重新 执行 ./unstuck.sh 和 ./stack.sh， 可 能 有 了 服务 没有 启动 或 不 正常 的 现象 。 


6.5 ”环境 验证 


不 要 看 到 命令 提示 成 功 就 以 为 DevStack 正 常 了 ， 还 需要 对 环境 进行 验证 ， 包 括 登 录 验 证 、 创 建 网 络 、 创 建 虚拟 机 、 网 络 测试 等 内 容 。 


6.5.1 ”登录 验证 


在 浏览 器 中 输入 部 署 成 功 后 显示 的 IP 地 址 : http://10.20.0.50/dashboard/， 正 常会 出 现 如 图 6-16 所 示 的 页 面 。 


3602 $308 RE 8.1 x Së te IB we Y" 5 x 
© € c oU 10.20.0.50 t v O. 

Fi. Uu 手机 收藏 交 sk SERE 2" PPR SSS Manu Mapp "baby "bike “hadoop "Lenovo M Links fo M mooc Mi movie lira - Hauen ORE - GER ~ Gem > Rs 
P & B= - OpenStack Dashboar * -— 
openstack 

学 
aH 
用 户 名 
| 
=H 
a 
HES 0 ERU a TE p £ = 


图 6-16 BREW 


在 “用 户 名 ”文本 框 中 输入 “demo”， 在 “密码 ”文本 框 中 输入 “123456”， 就 可 以 使 用 Mitaka 版 的 OpenStack 了 ， 如 图 6-17 所 示 。 





























E 360 实 全 浏览 如 8.1 > 内 x«& 2S sm IR am | — O X 
[€ [e^ 仑 Ú @ http;//10.20.0.50/dashboard/project/ “ev ~ 同和 ~ 加 ~ 一 -~ 加 ~ 月 
> C | 实例 概述 - OpenStack Dashboarc |+ E D> 
EB openstack admin ~ A stains 

| 
» x 
项 上 ~ 概述 
= `| 上 限 摘要 
概述 
实例 
5 
实例 VCPU 数量 内 存 浮动 |P 
映像 已 用 0 ， 可 用 10 已 用 0 ， 可 用 20 已 用 0 ， 可 用 51200 已 用 0 ， 可 用 50 
访问 & 安全 y 
网 络 ~ | 
安全 组 B 
对 象 存储 v 已 用 1 ， 可 用 10 ERO, 可 用 10 
管理 员 | 
身份 管理 " | 2 
| 卷 存 储 
已 用 0 ， 可 用 1000 


Os 


(5nBaüm [sms © Wie VRS FP Ø D W a125% 


图 6-17 登录 主页 


如 果 没 有 在 local.conf 中 配置 Neutton， 将 使 用 默认 的 Nova Netwoftk， 在 页 面 上 看 不 到 网 络 菜 单 ， 如 图 6-18 所 示 。 


D openstack Œ demo + & demo v 
En - 概述 
一 “| 上 限 摘要 
| " 
a" y l y 
e 
实例 VCPU 4&9 pi 浮动 IP HLH [3 
na fa 已 用 1, am 10 EH. 司 用 20 已 用 村 ,可用 51200 2m0. 可 用 10 Bg 1. 可 用 0 已 用 0 ,， 司 用 加 
访问 & 安 全 
身份 管理 | 
开发 者 - eva 
已 用 0， 可 用 1000 
使 用 情况 摘要 
选择 一 段 时 间 来 查询 其 用 量 : 
开始 时 间 : — 2016-10-01 SENA: 2015-10-11 | a YYYY-mm-dd dst « 
SAEC: 1 活动 的 RAM: 54MB 此 周期 内 的 VCPU- 小 时 数 : 006 此 周期 内 的 GB- 小 时 数 : 000 此 周期 内 的 RAM EE: 389 
tHE £T csi dm 
实例 名 称 VCPU &@ 磁盘 内 存 创建 以 来 的 时 间 


6.5.2 ”创建 网 络 


在 界面 左 侧 找 到 网 络 菜单 ， 如 图 6-19 所 示 。 


图 6-18 没有 网 络 菜单 的 页 面 














HRA M 





图 6-19 网络 菜单 


默认 会 看 到 public， 现 在 创建 一 个 私 网 ， 网 络 名 字 为 Sub， 子 网 名 称 为 Sub172， 地 址 为 172.16.0.0/24， 如 图 6-20 所 示 。 


Q | + 创建 网 络 Bee 


口 BR 子 网 已 连接 共享 外 部 状态 管理 状态 2 fF 
O sub sub172 172.16.0.0/24 False False 活动 启动 编辑 网络 了 
O public False True 活动 启动 


正在 显示 2 项 


图 6-20 创建 网 络 


创建 路 由 时 指定 外 部 网 络 ， 如 图 6-21 所 示 。 


创建 路 由 器 


CASERTA *F 
router JER: 
1e FHiBsE SS Zu cies Aes o 


gi 





图 6-21 创建 路 由 


单 击 路 由 名 称 “router” 来 添加 接口 ， 选 择 sub 的 子 网 ， 如 图 6-22 所 示 。 


添加 接口 
子 网 * 
sub: 172.15.0.0/24 (sub172) 


IP db (ale) o 


路 由 器 名 称 * 


router 


dms 





添加 成 功 之 后 选择 “网 络 拓扑 ”选项 ， 会 出 现 如 图 6-23 所 示 右 侧 的 内 容 。 到 这 里 网 络 创建 完成 。 


OcB4defic-92ce-15665-ac75-3a934fe 3fe452 


Ja: 
Tan pL fr —-p38xEBIT Edi RES Ez 


BrelsESEDIBYERSSIP 地 址 是 所 选 子 网 的 网 天 。 您 可 在 此 
址 指定 接口 的 到 一 个 IP 地址 Engin EL ESA hA 
指定 IP 地 址 所 属 的 子 阿 ， 


取消 





7 T 网 络 拓扑 


在 拓 扑 图 上 上 下 渡 动 您 的 妮 标 /种 挥 要 来 芋 整 国 布 大小 。 


HA 
ZE: ^ 
Pdsg RP 
pod 
fe FA es 
Shel . 
HEA v 

oir 


在 创建 实例 之 前 必须 要 把 网 络 创建 好 。 


6.5.3 ”创建 实例 


回 到 “计算 -实例 ”菜单 ， 如 图 6-24 所 示 。 


aum LRT 


HE CHAIR BE S 





7 = 实例 


计算 A 实例 名 字 = v ht ”| a 启动 实例 


实例 名 称 ”映像 名 称 Phd Ab ZAH 状态 JAk £5 电源 状态 创建 以 来 的 时 间 操作 


概述 
没有 要 显示 的 条 目 。 
实例 
卷 
映像 
访问 & 安全 


图 6-24 “计算 -实例 ”菜单 


创建 实例 ， 并 填 入 简单 的 信息 ， 如 图 6-25 所 示 。 





局 动 实 例 
请 提 世 实例 的 初 嫌 主机 各 ， 将 要 部 署 的 可 用 域 和 洋 例 计数 。 TH ea AS + aR Able 9o 
Instance Name * 实例 总 计 (10 最 大) 
test Ey 

flavor * Hm E 10% 

网 络 兴 nova ogo ss 

ZI Count * - E 

安全 组 | 

WAR] 

配置 

元 数据 

x 取消 


EE : & 启动 实例 





图 6-25 创建 实例 


单 击 下 面 加 号 按钮 ， 添 加 映像 ， 如 图 6-26 所 示 。 
单 击 m1.micro 右 侧 的 加 号 按钮 ， 添 加 模板 ， 如 图 6-27 所 示 。 
单 击 sub 右 侧 的 加 号 按钮 ， 添 加 网 络 ， 如 图 6-28 所 示 。 


如 果 没 有 特殊 选项 可 以 单 击 “ 启 动 实例 ”选项 ,创建 成 功 之 后 ， 如 图 6-29 所 示 。 





flavor * 


pdig * 


Ped 3 im O 


安全 组 


EAR] 


BIS 


元 数据 


x 取消 


网 北端 口 


安全 组 


SE SH 


Bi 


元 数据 





3c pi ze Ae SIE SOLARA AIS Bl. ARR SRS CORRELA) 。 你 也 可 以 选择 通过 创建 新 o 








KERAPA ANTIE o 
Xf SE Bi We 
an "| |# ES 
EB 
名 称 已 更 新 去 小 Xm 
AAS PS a RA PR. 
v oA) 
Q | 单 击 此 处 以 和 过滤 。 
m^ 已 更 新 Ah Xm 
> ciros-0.3 4-x86 64-uec obi e 24 00 MB AMI 
€ at [s] 
图 6-26 添加 映像 
flavor FELPA. EFE TEE EE BHA e 
Bam 
m VCPU #& RAM 酚 盘 总 计 AR iit 
> minano 1 54 MB 0 GB 0 GB 0 GB 
val 
Q | SIE REEL TE e 
BE VCPU & RAM* EAH RRA 
> mi micro 1 128 MB 0 GB 0 GB 0 GB 
> mitiny 1 512 MB 1GB 1 GB 0 GB 


图 6-27 添加 模板 


临时 磁盘 


临时 醋 盘 


可 见 

选择 一 个 
可 见 
公有 + 


@ 自动 实例 





A 

ri Es 
选择 一 个 

公有 

z + 

n + 








Pedir m LI] 


安全 组 
SEE 
Bi 


元 数据 


x 职 消 


go tesi 


正在 显示 1 项 


到 这 里 可 以 就 认为 初步 成 功 了 ， 其 实 还 有 关键 的 一 步 


映像 名 称 


cirros-0.3.4- 
x86 64-uec 


6.5.4 ”验证 实例 网 络 


码 


单 击 虚 拟 机 的 名 称 ， 然 后 找到 控制 台 ， 如 图 6-30 所 示 。 这 时 候 输入 不 了 相关 字符 ， 需 要 再 次 单 击 “ 单 击 此 处 以 仅 显 示 控 制 台 
"cubswin: ) ” 即 可 登录 该 实例 。 


首先 查看 一 下 是 否 获取 到 IP 地 址 ， 如 图 6-32 所 示 。 


oor 


在 云 中 ， Peles ASC dE Hi Se BiB o 
w E ER 


zE 子 网 已 关联 
$1 9 sub sub172 
w 可 用 
Q Bib | j 
Pii ^ 子 网 已 关联 
图 6-28 添加 网 络 
IP 地 址 Joh S 
对 
17216011 minano - 


图 6-29 ”创建 成 功 





该 IP 地 址 应 该 与 实例 显示 页 面相 一 致 ， 是 从 sub172 的 DHCP 池 中 取出 的 。 


ping 网 关 172.16.0.1 测 试 网 络 的 连通 性 ， 若 出 现 图 6-33 所 示人 信息， 表示 网 络 功能 正常 。 


到 这 里 ， 我 们 使 用 VMware 部 署 的 DevStack 验 证 完成 ， 基 本 功能 正常 。 


E 





AM T DSUs A A AAR e 
共享 的 e mulis HE 
iN LEE 活动 = 
Ete a E 
共享 的 e Boni HE 
fe Ang 
c 38 [n] 下 一 项 3 & Bens. fil 
$ um df Hu 创建 以 来 的 操作 
a tab 5. ”状态 时 间 ] 
和 IUS ga TT ~ 
动 TT 


网 络 验证 ， 下 面 我 们 就 登录 该 实例 ， 验 证 一 下 虚拟 机 的 网 络 。 


”， 如 图 6-31 所 示 。 现 在 可 以 输入 字符 了 ， 输 入 “cirros” 及 密 


创建 快照 v 


实例 控制 台 


RSH MRE HA: 请 单 击 下 面 的 榨 色 状态 栏 。 单 击 此 处 以 公 显 示 控 制 台 
要 退出 全 屏 模 式 ， 请 单 击 浏览 器 的 后 退 按 钮 。 


led) tc Si Send CtrlAltDel 
9.7160671 NET: Registered protocol family 1? 
9.716425] Registering the dns_resolver key type 
9.819208] scsi 1:0:1:0: CD-ROM QEMU QEMU LO 
ANSI; 5 
3.8654281 srO: scsi3-mmc drive: 4x/4x cd/rw xa/formZ tray 
3.8728131 cdrom: Uniform CD-ROM driver Revision: 3.20 
9.917219] sr 1:0:1:0: Attached scsi generic sgO type 5 
10.0111181] registered taskstats version 1 
12.2128481 Freeing initrd memory: 3656k freed 
13.4926071 Magic number: 4:666:493 
13.512155] rtc cmos 00:01: setting system clock to 2016-10-11 18:30:09 UTC ¢ 
1476210609) 
[ 13.5175891 powernow-k&: Processor cpuid 663 not supported 
[ 13.5300031 BIOS EDD facility v0.16 2004-Jun-25, O devices found 
[ 13.5316891 EDD information not available. 
[ 13.6969451 Freeing unused kernel memory: 928k freed 
[ 13.7242561 Write protecting the kernel read-only data: 12288k 
[ 14.014451] Freeing unused kernel memory: 1596k freed 
[ 14.2588661] Freeing unused kernel memory: 1184k freed 


further output written to /dev/ttyso0 


login as 'cirros' user. default password: 'cubsuin:)'. use 'sudo' for root. 
test login: 


图 6-30 ”实例 控制 台 


sv Q, 


网 址 大 全 PRPS e baby bike hadoop Lenovo Links fo mooc movie foie ~ Elo 


Connected (unencrypted) to: QEMU (instance-00000001) Send CtrlAltDel | 
9.7160671 NET: Registered protocol family 17 
9.716425] Registering the dns_resolver key type 
9.8192081 scsi 1:0:1:0: CD-ROM QEMU QEMU DUD-ROM 
: 9 ANSI: 5 
3.8654281 srO: scsi3-mmc drive: 4x/4x cd/rw xavform2 tray 
9.8728131 cdrom: Uniform CD-ROM driver Revision: 3.20 
3.917219] sr 1:0:1:0: Attached scsi generic sgQ type 5 
3.011118] registered taskstats version 1 
2.212848] Freeing initrd memory: 3656k freed 
.492607 1 Magic number: 41:686:493 
rtc cmos 00:01: setting system clock to 2016-10-11 18:30:09 UTC ( 


.5175891] pouernow-k8: Processor cpuid 663 not supported 
5300031 BIOS EDD facility v0.16 2004-Jun-25, O devices found 
3.531689] EDD information not available. 
3.696945] Freeing unused kernel memory: 928k freed 
3.724256] Write protecting the kernel read-only data: 12288k 
.014451] Freeing unused kernel memory: 1596k freed 
.258866] Freeing unused kernel memory: 1184k freed 


further output written to /dev/ttyso 


login as 'cirros' user. default password: 'cubswin:)'. use 'sudo' for root. 
test login: 


图 6-31 交换 的 控制 台 


<LOOPBACK,UP,LOWER_UP> mtu 16436 gdisc noqueue 
link*loopback 00:00:00:00:00:00 brd OO:O00:00:00:00:600 
inet 127.0.0.1/6 scope host lo 
inet ::17126 scope host 
valid_ lft forever preferred_Ift forever 
ethü: <BROADCAST,MAULTICAST,UP,LOWER_UP> mtu 1450 gdisc pfifo fast glen 1000 
link/ether fa:ib:3e:3a:bl:e4 brd fFRifP if fh PP EE 
inet 172.16.0.101/24 brd 172.16.0.255 scope global eth 
inet6 feB80::f815:3eff:fe3Ja:ble4^64 scope link 
valid lft forever preferred_Ift forever 


图 6-32 ”查看 了 地 址 





8.1 
.1 (172.165.0.1): 56 data bytes 


172.15.0.1: 
17Z2.1b5.0.1: 
172.156.0.1: 


seq-0 ttl=64 time=-49.379 ms 
seq-1 ttl-64 time-5.871 ms 
seq-2 ttl-64 time=2.3235 ms 


172.16.0.1 ping statistics 一 一 一 
3 packets transmitted, 3 packets received, Ox packet 





round-trip min/avg/max = 


6.5.5 ”OpenStack 版 本 


下 面 需 要 确认 一 下 部 署 的 是 不 是 Mitaka 的 版 本 ， 执 行 如 下 命令 : 





[root@control ~]# cd /opt/stack/nova/ 
[root@control nova]# git branch 














* stable/mitaka 














如 果 显 示 的 是 “*stable/mitaka”， 则 代表 部 署 的 正 是 Mitaka 版 本 。 


oor 


@.325419.191/49.3579 ms 


图 6-33 网络 连 通 性 测试 


如 果 想 部 署 其 他 版 本 的 OpenStack， 可 以 在 local.conf 文 件 中 指定 版 本 或 在 开始 使 用 Git 下 载 其 他 版 本 的 DevStack。 


6.6 错误 分 析 


部 署 DevStack 会 经 常 出 错 ， 当 把 Git 改 成 国内 的 地 址 后 已 经 改善 了 很 多 ， 


6.6.1 日 志 目 录 


笔者 在 2015 年 部 署 DevStack 时 花 了 一 周 左 右 的 时 间 ， 而 现在 部 署 Mitaka 大 概 需要 一 天 的 时 间 ， 包 括 排 错 和 查找 资料 。 


Devstack 的 日 志 目 录 不 在 /varlog 下 ， 而 是 在 /opt/stackyVlogs 目 录 下 ， 出 错 之 后 会 有 如 图 6-34 所 示 的 提示 信息 。 此 时 可 去 日 志文 件 中 查看 一 下 上 下 文 ， 找 到 错误 发 生 的 原因 ， 然 后 根据 错误 原因 去 解决 


该 错误 ， 再 重新 部 署 。 


t./stack.sh:exit trap:474 
^tt./stack.sh:exit trap:475 


./stack. 
./Stack. 
wf Stack. 
./stack. 
./stack. 
./Sstack. 
rror on 
./stack. 
./stack. 
./Stack. 
./stack. 


十 十 十 十 国 十 十 十 十 十 十 


sh:exit trap 
sh:exit trap 
sh:exit trap 


:475 
:478 
:484 


sh:kill spinner:370 


sh:exit trap: 
sh:exit trap: 


exit 


sh:exit trap: 
sh:exit trap: 
sh:exit trap: 
sh:exit trap: 


6.6.2 ”使 用 Git 下 载 代码 出 错 


部 署 时 可 能 会 出 现 如 图 6-35 所 示 的 错误 。 


A86 
487 


488 
489 
492 
496 


jobs -p 

jobs= 

[[ -n ** J] 

kill spinner 

r[* EET -e t! ry]! 


[Lf 1 -ne 0 [] 
echo 'Error on exit' 


generate-subunit 1476196424 2504 fail 
[[ -z /opt/stack/logs 1] 
fopt/devstack/tools/worlddump.py -d /opt/stack/logs 






exit 1 


图 6-34 logH X 


+inc/python: setup package with constraints edit:303 
+inc/python: setup package with constraints edit:304 local flags--e 

+inc/python: setup package with constraints edit:305 local extras= 

+inc/python: setup package with constraints edit:307  '[' -n /opt/stack/requirements ']' 

+inc/python: setup package with constraints edit:309 local name 

++inc/python: setup package with consbrainte edit:310 awk '/^name.*=/ {print TAS E alt cfg 
awk: fatal: cannot open file opt cinder/ ap. cfg for readino uch | dire 

*inc/python: setup package _ with constraints edit: 310 name= 

+inc/python: setup package with constraints edit: 1 exit trap 

t./stack.sh:exit trap:474 local r-2 

Tt./stack.sh:exit trap:475 jobs -p 

./stack.sh:exit trap:475 jobs- 

./stack.sh:exit trap:478 Ef -n ** 1] 

./stack.sh:exit trap:484 kill spinner 

./stack.sh:kill spinner:370 REP Eph cg: SE YI? 

./stack.sh:exit trap:486 [[ 2 -ñe O JJ 

./stack.sh:exit trap:487 echo 'Error on exit' 

Error on exit 
+./stack.sh:exit_trap:488 
+./stack.sh:exit_trap:489 
+./stack.sh:exit trap:492 
+./stack.sh:exit trap:498 


local project dir-/opt/stack/cinder 






十 十 十 十 十 十 


generate-subunit 1476137304 341 fail 

[[ -z /opt/stack/logs ]] 
/opt/devstack/tools/worlddump.py -d /opt/stack/logs 
exit 2 


图 6-35 log 文件 没 找到 


出 现 该 错误 的 原因 是 cinder 的 代码 没有 下 载 下 来 ， 出 现 这 种 情况 后 可 以 重新 执行 ./stack.sh， 也 可 以 手工 下 载 cinder 的 代码 ， 命 令 如 下 : 





gitclone http://git.trystack.cn/openstack/cinder.git /opt/stack/cinder -b stable/mitaka 


6.6.3 ”网 络 配置 错误 


部 署 时 可 能 会 出 现 如 图 6-36 所 示 的 错误 。 发 生 该 错误 的 原因 是 多 配置 了 一 个 选项 ， 如 图 6-37 所 示 。 这 个 选项 是 Neutron 组 件 ， 会 创建 一 个 私有 的 网 络 。 


6.6.4 ”重新 部 署 


如 果 在 创建 各 组 件 服务 后 出 现 错误 ， 则 需要 先 执行 ./unstuck.sh 和 载 相关 组 件 ， 如 图 6-38 所 示 。 例 如 ， 对 于 6.6.3 节 提 及 的 错误 ， 就 需要 先 镍 载 相 关 组 件 表 重新 安装 。 


++1ib/neutron-legacy: neutron create private subnet v4:1243 local subnet id 
+++lib/neutron-legacy: neutron create private subnet v4:1244 neutron subnet- -create —tenant- -id 
0a9023e --ip version 4 C 586 : : OCT7TC9923 
+++lib/neutron-legacy: _ neutron atm abest FS 1244 
+++functions-—common: get_field: 700 local data field 
+++lib/neutron-legacy: neutron create private subnet v4:1244 

+++functions-—common:get_field:701 read data 
Invalid input for operation: Gateway is not valid on subnet. 
Neutron server returns request ids: ['req-8icf48fe-709c-49fd-8ead-732cccc62395'] 
T-lib/neutron-legacy: neutron create private subnet v4:1244 subnet id- 
++lib/neutron-legacy: neutron create private subnet v4:1245 die if not set 1245 subnet id 'Failure creating 
704a3011cfc48229997205160a9023e' 

T-functions-common:die if not set:204 local exitcode-0 

[ERROR] /opt/devstack/functions-common:1245 Failure creating private IPv4 subnet for 
0a9023e 
*lib/neutron-legacy:create neutron initial network:554 
./stack.sh:1248:create neutron initial network 
/opt/devstack/lib/neutron-legacy:554: neutron create private subnet v4 
/opt/devstack/lib/neutron-legacy:1245:die if not set 
/opt/devstack/functions-common:211:die' 
-lib/neutron-legacy:create neutron initial network:1 
t./stack.sh:exit trap:474 local r=1 
Tt./stack.sh:exit trap:475 jobs -p 





get field 2 


grep ' id ' 


SUBNET ID-'[Call Trace] 


exit trap 


t./stack.sh:exit trap:475 jobs- 
+./stack.sh:exit_trap:478 [I — ** 1] 
+./stack.sh:exit_trap:484 kill spinner 
+./stack.sh:kill_ spinner:370 CPE ae) exc SE ogg 
t./stack.sh:exit trap:486 [[ 1 -ne O ]] 
t./stack.sh:exit trap:487 echo 'Error on exit' 


## Neutron options 
Q USE SECGROUP-True 


图 6-36 ”网 络 配 置 错误 


FLOATING RANGE-"192.168.0.0/24" 
|" b Er 


m ALGa dul 





RANCE-"10.0.1.0/24 
Q FLOATING ALLOCATION 


PUBLIC NETWORK GATEWAY—"192.168.0.200" 
PUBLIC INTERFACE-—enolo7771736 


图 6-37 找到 错误 


| POOL-start-192.165.0.250,end-192.168.0.254 


[stack@control devstack]$ ./unstack.sh 
WARNING: setting legacy OS TENANT NAME to support cli tools. 


t./unstack.sh:main:96 run phase unstack 

-functions-common:run phase:1851 local mode-unstack 

+functions—common:run phase:1852 local phase- 

Tfunctions-common:run phase:1853 [I -d /opt/devstack/extras.d ]] 

-functions-common:run phase:1854 local extra plugin file name 

-functions-common:run phase:1855 for extra plugin file name in 'STOP DIR/extras.d/*.sh' 
-functions-common:run phase:1860 local 'exceptions-60-ceph.sh 80-tempest.sh' 
Tfunctions-common:run phase:1861 local extra 


图 6-38 PRPA 


6.7 ”本章 小 结 


本 章 主要 讲 了 使 用 VMware 虚拟 机 进行 Devstack Mitaka 的 部 署 ， 包 括 配 置 文件 的 编写 、 相 关 的 注意 事项 及 排 错 等 内 容 。 


BIA FRNA 


从 本 章 开始 逐 渐进 入 OpenStack 的 开发 ， 下 面 先 简单 讲解 一 下 相关 内 容 ， 为 后 面 的 学 习 打 下 基础 。 


7.1 Screen 人 简介 


screen 是 一 个 可 以 在 多 个 进程 之 间 复 用 一 个 物理 终端 的 窗口 管理 器 。screen 中 有 会 话 的 概念 ， 用 户 可 以 在 一 个 screen 会 话 中 创建 多 个 Screen 窗口， 在 每 一 个 Screen 窗口 中 就 像 操 作 一 个 真实 的 SSH 连 接 
窗口 那样 。 


简单 来 说 ， 可 以 把 screen 理 解 成 Linux nohup 的 升级 版 ， 即 后 端 运行 任务 。 


71.1.1 screen 的 进入 
使 用 DevStack 部 署 的 OpenStack 与 使 用 其 他 方法 部 署 的 OpenStack 有 很 大 区 别 。 使 用 DevStack 安 装 的 OpenStack 服 务 均 运 行 在 Linux 的 screen 中 ， 而 非 Systemd 中 。 初 次 使 用 screen 时 ， 难 免 会 不 习 
E, 但 习惯 了 就 会 觉得 很 方便 。 


1) 查看 当前 用 户 开启 的 所 有 Screen， 执 行 “screen-list”， 如 图 7-1 所 示 。 


[rootücontrol ~]# su - stack 
Last login: Tue Oct 11 22:30:30 CST 2016 on pts/0 
[stack@control ~]$ screen -list 
There 1s a screen on: 
41197.5tack (Detached) 
1 Socket in /var/run/screen/S-stack. 


图 7-1 #AscreenF X 


2) 进入 该 screen 中 ， 命 令 如 下 : 





screen -r 41197 





3) 进入 Screen 会 话 中 ， 如 图 7-2 所 示 。 


-backup", "description": "Create a backup of a server."}, i updated": _"2014-12-03T00:00:00Z", "name": "Createserverext", "links": [], " 

namespace": "http://docs.openstack.org/compute/ext/fake xml", "alias": "os-create-server-ext", "description": ""}, {"updated" : "2014- 12 

-03T00:00:00Z", "name": "DeferredDelete", "links": [], "namespace": "http ://docs. openstack. org/compute/ext/fake xml", "alias": "os-defe 

rred-delete", "description": "Instance deferred delete."}, {"updated": 04 和- 12-03T00:00:0 

2016-10-11 18:41:27.266911 

2016-10-11 18:41:27.618497 DEBUG:keystoneauth.session:REQ: curl -g -i -X GET http://10.20.0.50:5000/v3/users/80c12bal1a57049ac96cc282fb9 

i A he -H "User-Agent: python-keystoneclient" -H "Accept: application/json" -H "X-Auth-Token: {SHA1}789bfab5d1d3c38eab0f54f5cd 

ab6olefc/618e77" 

2016-10-11 18:41:27.634108 DEBUG:keystoneauth.session:RESP: [200] Content-Length: 664 Vary: X-Auth-Token Keep-Alive: timeout-5, max-100 
Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.1e-fips mod wsgi/3.4 Python/2.7.5 Connection: Keep-Alive Date: Tue, 11 Oct 2016 18:41:26 GMT 
Content-Type: application/json x-openstack-request-id: req-aa493c77-ef12-47ce-aa6f-878af4de4555 

2016-10- 11 18:41: 27. 634206 RESP BODY: {"links": {"self": "http: //10. 20.0.50: se Aa Sa ce ge creda A ipae ic cec ale - 


previous": null, "next": null}, "projects" : [f"is domain": false, "description": "", "lin Uself^: "http: //10. 20.0.50: 5000/v3/proje 
cts/45afala60c8a427e94405786abb661d6"}, "enabled": true, "1a": "Sarai abde8a427294405786abb66100", "parent id": "default", "domain id": 
"default", "name": "invisible to admin' '}, f'is domain": false, "description": "", "li : "self": "http://10. 20.0.50: 5000/v3/project 


s/6225e5243e6e4a357b048c8400162e30f "1, "enabled": true, "id": Shoo sie ante ats MEL. MERE. "parent id": "default", "domain id": 
default", "name": "demo"}]} 

2016-10-11 18:41:27.634316 

2016-10-11 18:41:27.675136 DEBUG:oslo_policy.policy:Rule [telemetry:compute statistics] does not exist 

2016-10-11 18:41:27.677960 DEBUG:oslo_policy.policy:Rule [default] does not exist 

2016-10-11 18:41:27.730483 DEBUG:oslo_policy.policy:Rule [telemetry:get meter] does not exist 

2016-10-11 18:41:27.731475 DEBUG:oslo_policy.policy:Rule [default] does not exist 

2016-10-11 18:41:28.416597 DEBUG:oslo_policy.policy:Rule [telemetry:compute statistics] does not exist 

2016-10-11 18:41:28.417192 DEBUG:oslo_policy.policy:Rule [default] does not exist 

2016-10-11 18:41:28.418004 DEBUG:0slo policy.policy:Rule [telemetry:get meter] does not exist 

2016-10-11 18:41:28.418449 DEBUG:oslo_policy.policy:Rule [default] does not exist 

2016-10-11 18:41:28.769664 DEBUG:keystoneauth.session:RESP: [200] Content-Length: 664 Vary: X-Auth-Token Keep-Alive: timeout-5, max-100 
Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.1e-fips mod wsgi/3.4 Python/2.7.5 Connection: Keep-Alive Date: Tue, 11 Oct 2016 18:41:27 GMT 
Content-Type: application/json x-openstack-request-id: req-7/bf95f4c-67f2-4efa-b642-9b5fabce0443 

2016-10-11 18:41:28.769789 RESP BODY: {"links": {"self": "http://10.20.0.50: 5000/v3/users/80c12bala57049ac96cc282fb9360a2c/projects", " 


previous": null, "next": null}, "projects": [í"is domain": false, "description": "", "links" Uself^: "http://10.20.0.50:5000/v3/proje 
cts/45afala60c8a427e94405786abb661d6"}, "enabled": true, "id": "dSafala60c8a427e94405786abb661d6". "parent id": "default", "domain id": 
"default", "name": "invisible to admin"j, í"is domain": false, “deasc r ECION a. "h "13 : t"self": "http://10. 20.0.50: 5000/v3/project 


s/6225e5243e6e4a57b048c8400162e30f"1, "enabled": true, "id": noe MERE, "parent id": "default", "domain id": " 
default", "name": "demo"}]} 

2016-10-11 18:41:28.769820 

2016-10-11 18:41:29.177642 DEBUG:0slo policy.policy:Rule [telemetry:compute statistics] does not exist 
2016-10-11 18:41:29.178396 DEBUG:oslo_policy.policy:Rule [default] does not exist 

2016-10-11 18:41:29.179332 DEBUG:0slo policy.policy:Rule [telemetry:get meter] does not exist 


"nbl 18:41:29.179789 DEBUG:oslo_policy.policy:Rule [default] does not exist 
12$(L) n-cond 13$(L) n-sch 14$(L) n-novnc 15$(L) n-cauth 16$(L) n-cpu 17$(L) c-api 18$(L) c-sch 19$(L) c-vol  20$(L) horizon* 


A\7-2 ”进入 screen 后 的 情况 


图 中 最 后 一 行 打 * 是 指 当 前 的 是 window 系 统 ， 目 前 在 hotizon 中 ; 举例 说 明 ，n-api 代 表 nova-api，c-vol 代 表 cindet-volume。 


7.1.2 screen 的 使 用 


按 Ctrl+A 组 合 键 ， 再 按 “，” 所 在 键 就 可 以 看 到 所 有 screen 列 表 ， 也 可 以 按 上 、 下 方向 键 进行 翻 页 ， 查 找 所 需要 的 服务 ， 如 图 7-3 所 示 。 


stackücontrol:/opt/devstack 
dstat 

key 
key-access 
g-reg 
q-ap1 
n-ap1 
q-SVC 
q-agt 
q-dhcp 

10 0-13 

11 q-meta 

12 n-cond 

13 n-sch 

14 n-novnc 

15 n-cauth 

16 n-cpu 

1/ c-ap1 

18 c-sch 

19 c-vol 


WO GO cuu e = 书 


norizon 





图 7-3 screen Zi] X 


oor 


图 7-3 中 的 q-dhcp 代 表 neutton-dhcp g-api4X Kglance-apic 


如 图 7-3 所 示 ， 找 到 所 需 服务 后 直接 按 回 车 键 即 可 进行 相应 的 服务 ， 比 如 选择 17 是 进入 c-api (cinder-api) ， 具 体 如 图 7-4 所 示 。 


2016-10-12 02:22:16.200 INFO eventlet.wsgi.server [req-314c4d7e-9efb-43b1-99a2-1079a95bdae4 80cli2bala57049ac96cc282fb9360a2c 45afala60c 

8a427e94405786abb661d6] 10.20.0.50 "GET /v2/45afala60c8a427e94405786abb661d6/volumes /detail?bootable-true&status-available HTTP/1.1" st 

atus: 200 len: 277 time: 1.1779439 

2016-10-12 02:22:16.468 INFO cinder.volume.api [req-ec8a4c48-0e35-4eb2-a217-d9d148a2e253 80c12bala57049ac96cc282fb9360a2c 45afala60c8a4 
27e94405786abb661d6] Get all snapshots completed successfully. 

2016-10-12 02:22:16.473 INFO cinder.api.openstack.wsgi [req-ec8a4c48-0e35-4eb2-a217-d9d148a2e253 80c12bala57049ac96cc282fb9360a2c 45afa 

1a60c8a427e94405786abb661d6] http://10.20.0.50:8776/v2/45afala60c8a427e94405786abb661d6/snapshots/detail?status-available returned with 
HTTP 200 

2016-10-12 02:22:16.514 INFO eventlet.wsgi.server [req-ec8a4c48-0e35-4eb2-a217-d9d148a2e253 80c12bala57049ac96cc282fb9360a2c 45afala60c 

8a427e94405786abb661d6] 10.20.0.50 "GET /v2/45afalia60c8a427e94405786abb661d6/snapshots/detail?status-available HTTP/1.1" status: 200 1 

en: 279 time: 0.4225411 


a 
12$(L) n-cond 13$(L) n-sch 14$(L) n-novnc 15$(L) n-cauth 16$(L) n-cpu 18$(L) c-sch 19$(L) c-vol 20-$(L) horizon 





图 7-4 进入 c-api 


按 Ctrl+C 组 合 键 ， 可 停止 该 服务 ， 如 图 7-5 所 示 。 再 按 下 向 上 方向 键 ， 会 出 现 运 行 的 上 条 命令 ， 如 图 7-6 所 示 。 直 接 按 Enter 键 即 可 再 次 运行 该 命令 了 。 


^C2016-10-12 06:32:26.926 INFO oslo service.service [-] Caught SIGINT signal, instantaneous exiting 
2016-10-12 06:32:27.040 INFO oslo service.service [-] Caught SIGINT signal, instantaneous exiting 
2016-10-12 06:32:27.396 INFO oslo service.service [-] Caught SIGINT signal, instantaneous exiting 
C-api failed to start 

[stackücontrol devstack]$ 


12$(L) n-cond 13$(1) n-sch 14$(L) n-novnc 15$6L) n-cauth 316$(L) n-cpu 17$01) c-api* 18$(1) c-sch 


图 7-5 ”停止 c-api 服 务 


[stack@control devstack]$ fes rio i tae --config-file /etc/cinder/cinder.conf & echo $! »/opt/stack/status/stack/c-api.pid; fg || 
echo "c-api failed to start" | tee "/opt/stack/status/stack/c-api.failure" 


12$(L) n-cond 13$(L) n-sch 14$(L) n-novnc 15$(L) n-cauth 16$(L) n-cpu 17$(L) c-api* 18$(L) c-sch 19$(L) c-vol 20-$(L) horizon 
图 7-6 ”查看 c-api 命 令 


按 Ctrl+A+n (n 代 表 该 服务 $ 前 面 的 数字 ) 组 合 键 ， 会 在 不 同 的 服务 之 间 进 行 切 换 ， 如 按 Ctrl+A+9 (q-dhcp) 组 合 键 ， 如 图 7-7 所 示 。 


2016-10-12 06:48:44.798 DEBUG oslo_concurrency. lockutils [-] Lock ". check child processes" released by "neutron.agent. linux.external_pr 
ocess. check child processes" :: held 0.003s from (pid-60350) inner /usr/ lib/python2.7/site-packages/os lo. concurrency/ lockuti ls. py:282 


9$(L) 10$(L) q-13 11$(L) q-meta 12$(L) n-cond 13$(L) n-sch 143(L) n-novnc 15$(L) n-cauth 16$(L) n-cpu 1/-$(L) c-api 1 





图 7-7 gq-dhcp 服 务 


如 果 要 输入 两 位 数字 ， 需 要 按 Ctrl+A 组 合 键 ， 再 按 “” 所 在 键 ， 然 后 输入 两 位 数据 按 Enter 键 即 可 切换 ， 如 图 7-8 所 示 。 





(L) n-sch 14$(L) n-novnc 15$(L) n-cauth 16$(L) n-cpu* 


图 7-8 切换 到 n-cond 服 务 


移 到 下 一 个 Windows 的 命令 : Ctrl+A+n 组 合 键 。 


移 到 前 一 个 Windows 的 命令 : Ctrl+A+P 组 合 键 。 


掌握 以 上 这 些 内 容 可 以 满足 日 常 screen 的 使 用 ， 还 需要 自己 练习 一 下 。 


7.1.3 ”screen 的 退出 


按 Ctrl+A 组 合 键 ， 再 按 “，” 就 可 以 看 到 所 有 screen 列 表 ， 把 光标 移 到 0 处 ， 然 后 按 回 车 键 ， 如 图 7-9 所 示 。 


Num Name 


Ü <Gcontro!:/opt/devstack 





1 dstat 
2 key 
3 key-access 
4 g-reg 
5 g-apl 
然后 输入 screen-d 即 可 退出 screen 的 状态 ， 如 图 7-10 所 示 。 


[stack@control devstack]$ screen -di 


0$ stackücontrol:/opt/devstack* 1$(L) dstat 2$(L) key 3$(L) key-access 4$(L) g-reg 5$(L) g- 
图 7-10 ”退出 screen 状 态 


退出 screen 的 提示 如 图 7-11 所 示 。 


[remote detached from 41197.stack| 
[stackücontrol —]$ 


图 7-11 退出 screen 的 提示 


7.2 API 调试 


本 节 主 要 学 习 OpenStack API 及 API 的 使 用 。 


7.2.1 API 


首先 来 看 一 下 系统 使 用 了 什么 API。 

1. 成 为 OpenStack 管 理 员 

先 查看 一 下 安装 的 DevStack 的 各 API 版 本 ， 进 行 到 DevStack 的 目录 ， 先 成 为 OpenStack 的 管理 员 ， 如 图 7-12 所 示 。 
[stack@control ~]$ cd /opt/devstack/ 
[stack@control devstack]$ . openrc admin 


WARNING: setting legacy OS TENANT NAME to support cli tools. 
[stack@control devstack]$ 


图 7-12 ”成 为 OpenStack 的 管理 员 
2. 查 看 API 版 本 


查看 API 版 本 需要 执行 如 下 的 命令 





openstack endpoint list 


输出 结果 如 图 7-13 所 示 。 


和 一 Parcs tr ss Trt d——--——-—--—---—-7-— 由 一 + 
| iD | Region | Service Maine | Service Type 

| ASISTIR ee rege AE NRI EE Use SE ee Ce Ee eS NUUS Paus puer pum fe ctc ELE dispu che ee ee gee 
| ed17790abc1140b685c9b3e402fdbbf8 | RegionOne | neutron | DE mea 

| db394c338a1/448895836dc36034d3947 | RegionOne | cinder | volume 

| 6036f7/859cc49bb9bd2ec9e348b501d | RegionOne | cinderv? | volumev2 

| 226ae4edc5b54546bf6b50d4c45b52ae | RegionOne | nova | compute 

| d52b3fda2c494f15a/ab9e6527b4d06f | RegionOne | glance | Image 

| 9963bc3ceabf435e863/1af//e40decO0 | RegionOne | nova legacy | compute legacy 
| 36e97a2d6d454b51937522d71611111e | Regionone | keystone | identity 
a qd ges ee E 一 Se 是 < 站 disci o uere siiis 


图 7-13 OpenStack API 


例如 ， 我 们 要 查看 图 7-13 中 keystone 的 API 的 端口 及 版 本 ， 需 要 执行 如 下 命令 : 








openstack endpoint show keystone 





输出 结果 如 图 7-14 所 示 。 


de resets ears ete Roost ote oe ee ee ee ee eh 
| Field | Value | 
quee memet ce 十 一 一 一 一 一 一 一 一 Cr a cop a Fr ETC EIE EET 一 
| adminur | | http://10.20.0.50:35357/v2.0 | 
| enab led | True | 
| id | 36e97a2d6d454b51937522d71611f1le | 
| internalur] | http://10.20.0.50:5000/v2.0 | 
| publicur] | http://10.20.0.50:5000/v2.0 | 
| region | Regi1onOne | 
| service 1d | /;di6e4e8bfil2f4/al196da4aae48bf279f | 
| service name | keystone | 
| service type | identity | 
CIE d 
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图 7-14 keystone 的 端口 及 API 版 本 
结果 显示 使 用 的 端口 是 35357/5000，API 的 版 本 是 “v2.0”。 
3. 查 看 官方 API 文 档 
在 浏览 器 中 输入 docs.openstack.org 找 到 APl 手 册 ， 如 图 7-15 所 示 。 


er 


也 可 以 直接 输入 地 址 http://developet.openstack.otg/ (因为 网 站 在 改版 ， 可 能 会 有 差别 ) o 


€» xX tú Ohr '-s.openstack.org 
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Æ API Guides 


API Guide 
OpensStack API Documentation 


图 7-15 KAPIZ 


进入 手册 ， 找 到 Identity API v2.0， 如 图 7-16 所 示 ， 


Q http://developer.openstack.org/api-quide/quick 
































s: OpenStack API | + 


Biock Storage API v2 
Deprecated API versions 


Block Storage AP! v1 





Identity API v2.0 





identity admin API v2.0 





Identity API v2.0 extensions 





image service API v1 


图 7-16 keystone API 连 接 


单 击 Identity API v2.0 链 接 后 ， 找 到 如 图 7-17 所 示 的 内 容 。 


s 


Tokens and tenants 


N2.0/tenants TUNE 


List tenants 


POST /v2.0/tokens P 


detail 
Authenticate 


图 7-17 keystone API 连 接 


单 击 POST 右 侧 的 detail 按 钮 可 显示 该 API 的 细节 ， 参 见 表 7-1。 


表 7-1 POST 提交 参数 细节 


Description 


The user name. Required if you include the password 


Name 





username ( Optional) body | | 
Credentials object. Otherwise, you must provide a token. 


TM ; A passwordCredentials object. To authenticate. you must 
passwordCredentials ( Optional ) body string 


provide either a user ID and password or a token. 








(5E) 
Name Description 
The tenant ID. Both the tenantId and tenantName attributes are 
tenantId ( Optional ) body string | optional and mutually exclusive. If you specify both attributes, the 
server returns the Bad Request ( 400 ) response code. 
A token object. Required if you do not provide a password 
token ( Optional) body object 
credential. 
The tenant name. Both the tenantId and tenantName attributes 
tenantName ( Optional ) body string | are optional and mutually exclusive. If you specify both attributes, 
the server returns the Bad Request ( 400 ) response code. 
The password of the user. Required if you include the 
password ( Optional) body string l . . 
passwordCredentials object. Otherwise, you must provide a token. 
id ( Optional) The token ID. This field is required in the token object. 


字段 说 明 : Optional 为 可 选项 ; 在 页 面 的 下 方 是 返回 的 JSON 文 件 内 容 ， 读 者 可 以 查看 一 下 。 后 面 的 API 实 验 会 见 到 ， 可 以 进行 对 比 。 


GET 方 法 的 细节 也 要 看 ，API 实 验 会 用 到 ; 其 他 API 读 者 可 以 自己 练习 。 


7.2.2 RESTClient LA 


RESTClient 是 一 个 用 于 测试 RESTful Web Services 的 Java 客 户 端 。 
1. 下 载 RESTClient 


下 载 地 址 为 https://github.com/wiztools/rest-client/releases。 在 下 载 页 面 选 择 restclient-ui-3.5-jar-with-dependencies 的 版 本 并 下 载 ， 如 图 7-18 所 示 。 
A | | 
restclient-3.5 
A subwiz released this on 27 Apr 2015- 69 commits to master since this release 


[maven-release-plugin] copy for tag restclient-3.5 


Downloads 
C restclient-cli-3.5-jar-with-dependencies.jar 3.16 ME 
CT restclient-ui-3.5-jar-with-dependencies.jar 13.6 MB 


[i] Source code (zip) 


È) Source code (tar.gz) 


图 7-18 下载 RESTClient 版 本 


oor 


cl 是 命令 行 的 版 本 ，ui 是 图 形 界面 的 版 本 。 
2. 运 行 RESTClient 


右 击 restclient-ui-3.5-jar-with-dependencies， 在 弹出 的 快捷 菜单 中 选择 “Java (TM) Platform SE binary” 命 令 ， 如 图 7-19 所 示 。 


rosielientania Siarawith sienendencies 2015/10/12 17:04. _ Executable Jar File — 13,946 KB | 


| HAO) 

E scr&g j 
打开 方式 [H] * ii] JavalT =k Platform SE binary 

| = 用 WinRAR 打开 fw 


B BEHA. 
B ernsten 














图 7-19 ”右键 运行 RESTClient 


加 载 过 程 会 显示 如 图 7-20 所 示 的 图 标 。 加 载 完成 的 界面 如 图 7-21 所 示 。 





图 7-20 RESTClientJe Rit FE 





4» WizTools.org RESTClient 3.5 
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图 7-21 RESTClientR 


3.API 测 试 获取 token 

1) 输入 URL 数 据 : 

URL: http://10.20.0.50:5000/v2.0/tokens 
2) 切换 到 Method 选 项 卡 ， 选 择 POSTT 方 法 。 
3) 切换 到 Header 选 项 卡 ， 填 入 如 下 的 信息 : 


Key:Content-Type 
Value: application/json 





填 入 以 上 内 容 之 后 单 击 右边 的 加 号 ， 如 图 7-22 所 示 。 
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图 7-22 Headerit 3 F 


4) 切换 到 Body 选 项 卡 ， 选 择 String body， 如 图 7-23 所 示 。 





uest 


— NI —— —— ——— 


URL: [ntp:710.20.0.50:5000N2.O/tokens 








































































图 7-23 String body 


在 空白 的 地 方 输入 如 下 信息 : 


{ 
"auth": { 
"LtenantName": "demo", 
"passwordCredentials": { 
"username": "demo", 
"password": "123456" 

} 


} 
} 


输入 后 如 图 7-24 所 示 。 


“auth”: 


tenani ame 





图 7-24 ”加 入 认证 信息 


5) 单 击 最 右 侧 的 上 闻 图 标 发 起 连接 ， 成 功 之 后 会 返回 如 图 7-25 所 示 的 内 容 。 


区 WizTools.org RESTClient 3.5 


























=a 
ie 


= An 4-97 AEE 34 AAA BWavrnirenc™ * | 
-10-12T00:55:34.000000Z", "expires": "20 
TWO Tam d dW CL UE Ego SIE ELM 


| Response time: 1391 ms; body-size: 2891 byte(s) | 
图 7-25 ”返回 结果 
在 下 面 出现 “access” 的 地 方 右 击 ， 在 弹出 的 快捷 菜单 中 选择 JSJON 格 式 ， 如 图 7-26 所 示 。 


把 token 中 的 id 取出 来 ， 如 图 7-27 所 示 。 





图 7-26 ” JSON 格式 化 


" Headers Test Result 





“access”: { 

"taken" : 1 
"issued at: 2016-10-12T00:55:34 0000002", 
soc Ra -10-12T UTISIA, 


'eddt J 73527. oO b5 58a7 bfa i Fry 


a tat Sol EN x m E md - uu iz 


‘tenant’ { 


“description” 

"enabled" : true, 
"id" -7622565243e686435/5048Cc8400162630f, 
"name": “dema” 





图 7-27 token id 
Qi 


需要 DevStack 的 防火 墙 中 放 开 5000 的 端口 ， 否 则 可 能 获取 不 到 数据 。 
4. 使 用 token 获 取 数 据 

1) 把 URL 改 为 http://10.20.0.50:5000//v2.0/tenants。 

2) 切换 到 Method 选 项 卡 ， 选 择 GET 方 法 。 


3) 切换 到 Header 选 项 卡 ， 填 入 如 下 的 信息 : 





Key: X-Auth-Token 
Value: edd833c3b2784b58a7bfaafdda0861d2 





填 入 以 上 内 容 之 后 单 击 右边 的 加 号 ， 如 图 7-28 所 示 。 


URL: http 0.20.0.50:5000//v 2.0/tenants| 





"Method | Header | Cookie | Body | Auth | SSL | Etc. | Test 


Key: | | Value: | | + | 





Header 





A-Auth-Token edd833c3b27 
Content-Type 


图 7-28  X-Auth-Token 


4) 单 击 最 右 侧 的 上 | 图标 发 起 连接 ， 成 功 之 后 会 返回 如 图 7-29 所 示 的 内 容 。 
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HTTP Response - 


| tenants | links" T] "tenants : [i "description": ^, enabled" : true, “id”: “45afalab0ce | 





| Formatted s ucces sfully. 


图 7-29 ”返回 结果 


在 下 面 出 现 “tenants_links” 的 地 方 右 击 ， 在 弹出 的 快捷 菜单 中 选择 JSON 格 式 ， 能 看 到 用 户 名 为 demo， 如 图 7-30 所 示 。 


HITP Response 
Status: HTTF/1.1 200 OK 


Headers | Body | TestResult 


"enabled" : true, a 
"id :"45afala60c8a427e94405/85abb661d6, 
“name”: “invisible ta admin" 


h 


"name" : "demo" 


i 

"description" : ^, 

"enabled": true, 

“Id” :*622565243e56435/b048c8400162630f', 

| z 


] 


图 7-30 #42) PS 


限于 篇 幅 ，API 的 基本 实验 就 讲 到 这 里 ， 对 于 其 他 API 实 验 ， 读 者 可 以 自行 练习 。 


7.2.3 “Curl 实 验 


图 形 界面 操作 对 于 初学 者 来 说 非常 直观 ， 测 试 API 也 可 以 使 用 Linux 系 统 自 带 的 Curl 命 令 。 官 方 的 参考 文档 如 下 : http://docs.openstack.org/developer/openstack-projects.html, 


在 页 面 上 找到 keystone， 单 击 链接 后 的 地 址 如 下 : http://docs.openstack.org/developer/keystone/。 向 下 拖 动 页 面 找到 “API Examples using Curl” 并 单 击 ， 进 入 如 图 7-31 所 示 的 页 面 。 
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API Examples using Curl 
vo API Examples Using Curl 


Tokens 


Default scope 


Get a token with default scope (may be unscoped): 


curl -i X 
-H "Content-Type: application json" X 
-d " 
tath s f 
“identity”: | 
“methods”: ["password"], 
“password”: | 
^Cuser":. { 
"name": "admin', 
“domains s d “ads cdeBaubb" E 
“password”: "adminpwd" 
} 
} 
! 
} 
DUX 


http://localhost:B5Üüü/sx3/auth/tokens ; echo 


图 7-31 


api-curl-examples 


在 左 侧 找到 “POST/tokens”， 并 单 击 ， 则 出 现 相 关 的 示例 ， 如 图 7-32 所 示 。 


POST ytokens 


Authenticate by exchanging credentials for an access token: 





$ curl -d 1 auth’: ["tenantName": "customer-x', "passwordCredentials"': 1 username": "joeus 
ed b 
图 7-32 Curl 
1.keystone 实 验 
把 内 容 复制 出 来 ， 然 后 手动 修改 成 自己 的 环境 。 原 始 数据 如 下 : 
curl -d '("auth":("tenantName": "customer-x", "passwordCredentials": ("username":"joeuser", "password": "secrete"}}}! -H "Content-type: application/json" http://localhost:35357 


根据 环境 修改 如 下 : 


curl -d '{"auth": {"tenantName": 


找 一 台 能 ping 通 192.168.0.50 的 Linux 主 机 或 者 使 用 本 机 ， 输 入 上 面 的 命令 ， 会 返回 如 图 7-33 所 示 的 结果 。 


"demo", "passwordCredentials": ("username":"demo", "password": "123456"}}}' -H "Content-type: application/json"http://192.168.0.50:5000/v2.0/tok 


[rootücontrol ~]# curl -d '{"auth":{"tenantName": "demo", "passwordCredentials": {"username": "demo", "password": "123456"}}}" -H "Cont 
ent-type: application/json" http://192.168.0.50:5000/v2.0/tokens 
{"access": i"token": : {"issued_at": "2016-10-11T17 : 36:48. 00000027", "expires": “2016-10-11T18:36:48Z ， "30 5 "a9952df75c454ca498e78a5b3db 
6ca37", "tenant": {' description": : "" "enabled": true, "id": "6225e5243e6e4a57b048c8400162e30f" , nime" - "demo"}, "audit ids": ["dy iBY9 
C _SUal IKfKecSxpw" lt, "serviceCatalog": [{"endpoints": [Íí"adminURL ": "http://10.20.0.50:8774/v2.1/6225e5243e664a57b048c8400162e30f" , "re 
gion": "RegionOne", "internalURL": "http: //10. 20.0. 50:8774/v2.1/6225e5243e6e4a57b048c8400162e30f" , " id": "0cce4740a02247d6be7 3227b9253d 
883", ""publicURL": ""http://10.20.0.50:8774/v2.1/6225e5243e6e4a357b048c8400162e30f"1] , "endpoints - links" [], "type": "compute", "name": 
"nova"}, {"endpoints": [{"adminURL": "http://10.20.0.50:9696/", "region": "RegionOne", "internalURL" : "http: //10. 20.0. 50: 9696/", "10"? 
"288cd05b2cdi4ddd89f7a6afclafla8b", "publicURL": "http://10.20.0.50:9696/"1], "endpoints. links": [], "type": "network", "name": "neutro 
n", {"endpoints": [í"adminURL": "http://10.20.0.50:8776/v2/6225e5243e6e4a57b048c8400162e30f" , "region": "RegionOne", *internalURL": "h 
ttp://10.20.0.50: 8776/v2/6225e5243e6e4a57b048c8400162e30f ", 38. "18d4995c7942434baca8d6ea549f1a12", "publicURL": "http: //10.20.0.50:8 
776/v2/6225e5243e6e4a57b048c8400162e30f ^1], "endpoints links": [], "type": "volumev2", "name": "cinderv2' '}, f'endpoints": [í"adminURL": 
"http://10.20.0.50:9292", "region" "Regionone", "internalURL": "http: //10. 20. 0. 50: 9292", "30^: "a8b335569be5417a850af 51f51bbfic9", "p 
ublicURL": "http://10. 20. 0.50: 9292"1], "endpoints. links": [], "type": "image", "name": " glance", {"endpoints": [í"adminURL": "http://1 
0. 20.0. 50:8774/v2/6225e5243e6e4a57b048c8400162e30F", "region": "RegionOne", "Interna lrL": "http://10.20.0.50:8774/v2/6225e5243e6e4a57b 
048c8400162e30f", "id": "4e3dic57ebaa478da18824f8a222843a", "publicURL": "http://10.20.0.50:8774/v2/6225e5243e6e4a57b048c8400162e30f" 1] 
, "endpoints links": [], "type": "compute legacy", "name": "nova legacy"), {"endpoints": [[í"adminURL": "http://10.20.0.50:8776/v1/6225e 
5243e6e4a57b048c8400162e30F", "region": "RegionOne", "internalURL": "http://10.20.0.50:8776/v1/6225e5243e6e4a57b048c8400162e30f", "id": 
"5e59ff8alb934ba8982ddcf 303bab44a" "publicURL": "http://10.20.0.50:8776/v1/6225e5243e6e4a57b048c8400162e30f"1], "endpoints links": [] 
, "type": "volume", "name": "cinder" +, {"endpoints": [í"adminURL": "http://10.20.0.50:35357/v2.0", "region": "RegionOne", "internalURL" 
:| “Hein: //10. 20. 0. 50: 5000/v2. 0", "id": "280b9cfa95e44993b54879e83907ff5f", "publicURL": "http://10.20.0.50:5000/v2.0"1], "endpoints lin 
: ms "identity", "name": "keystone"}], "user": {"username": "demo", "roles links": [], "id": "80c12ba1a57049ac96cc282fb9360 
a2c", "roles": [{"name": "anotherrole"], i"name": "Member"}], "name": "demo"}, "metadata": í"is admin": 0, "roles": ["2ee5bb7923d943778 
73e831bd241f7a0" , "14¢91c5c3ecd4bb2af76982050e52e62"]}}}[root@control ~]# 


图 7-33 ”返回 结果 


上 面 的 结果 阅读 起 来 比较 麻烦 ， 可 以 使 用 Python 程序 解析 一 下 ， 命 令 变 六 





curl -d '{"auth":{"tenantName": "demo", "passwordCredentials": ("username":"demo", "password": "123456"}}}' -H "Content-type: application/json"http://192.168.0.50:5000/v2.0/tok 


结果 为 JSON 格 式 ， 如 图 7-34 所 示 。 


[root@control ~]# curl -d '{"auth":{"tenantName": "demo", "passwordCredentials": {"username": "demo", "password": "123456"}}}' -H "Cont 
ent-type: application/json" http://192.168.0.50:5000/v2.0/tokens | python -mjson. tool 
% Total % Received % Xferd Average Speed Time Time Time Current 
Dload Upload Total Spent Left Speed 
109 2989 100 2891 100 98 4050 137 --:--:-- --:--:-- --:--:-- 4049 


"access" 1 
"metadata" s d 
"is admin": 0, 
roles": 
" 2ee5bb792 3d94377873e831bd241f7a0", 
] "14c91c5c3ecd4bb2af76982050e52e62" 


"ServiceCatalog": [ 
"endpoints": [ 
"adminURL": "http://10.20.0.50:8774/v2.1/6225e5243e6e4a57b048c8400162e30f" , 
"id": "Occe4740a02247 d6be7 3227b9253d883", 


"internalURL": “http://10.20.0.50:8774/v2.1/6225e5243e6e4a57b048c8400162e30F", l 
"publicURL": "http://10.20.0.50:8774/v2.1/6225e5243e6e4a357b048c8400162e30f" , | 


"region": "RegionOne" 
} 
"endpoints. links": [1], 
'name": "nova", 
"type" "compute" 


token": { | 
'audit ids": [ 
"oQhQMv33TdwrtXoz8JBGmg" 
] ， 


"expires" - 720165-10-11T18:-:39:107z", 
tds 3e36d021d04240cea03d724157 TERE". 
Issued at : 2016-10-11T1/ : 39:10. 0000002" , 
‘tenant’: 1 
"description": "r 
enabled": true, 
"Jd": "6225e5243e6e4a57b048c8400162e30f" , 
"name": "demo" 






f， 


图 7-35 ”得 到 token id 


找到 “GET/tenants” 的 API| 示 例 ， 如 图 7-36 所 示 。 


GET /tenants 


List all of the tenants in the system (requires an Admin x-Auth-Token) 


$ curl -H "Z-àuth-Token:999888TTTB8B55" http://localhost:353B5T/:2. O/tenants 


Heturns: 


"tenants links": [], 
"tenantz": [ 


| 
"enabled': false, 
“description”: “None”, 
“name”: “project-y”, 
"EH 357 dr 

Fa 

Í 
“enabled”: true, 
“description”: “None”, 
“name”: “ANOTHER: TENANT", 
"dd s us 

fa 

i 
"enabled': true, 
"description": “None”, 
"name": "customer-x', 
Siege AE E 

} 


图 7-36 tenants API 


修改 后 的 Curl 命 令 如 下 : 





curl -H "X-Auth-Token: 3e36d021d04240cea03d7241576c5624" http://192.168.0.50:5000/v2.0/tenants | python -mjson.tool 


返回 结果 如 图 7-37 所 示 。 


[root@control ~]# curl -H "X-Auth-Token:3e36d021d04240cea03d7241576c5624" http://192.168.0.50:5000/v2.0/tenants | python -mjson. tool 


% Total % Received % Xferd Average Speed Time Time Time Current 
Dload Upload Total Spent Left Speed 
100 240 100 240 0 0 724 Q--:--:-- --;--:-- --:--;-- 727 
kis andi [ 
"description": "", 
"enabled": true, 
"id": "45afala60c8a427e94405786abb661d6", 
i "name": "invisible to admin" 
k - 
"description": "" 
"enabled": true, 
"id": "6225e5243e6e4a57b048c8400162e30f" , 
; "name": "demo" 


"tenants links": [] 


图 7-37 返回 tenants 信 息 
在 keystone 实 验 中 ， 我 们 获取 到 token 的 id， 这 个 id 将 用 于 glance 实 验 。 
2.glance 实 验 
有 了 token 就 可 以 验证 其 他 API 了 ， 这 里 以 glance 的 AP 为 例 进行 说 明 ，glance 组 件 文档 网 址 为 : http://docs.openstack.org/developer/glance/, 


在 页 面 中 找到 “Images API v2” 并 打开 链接 ， 便 找到 了 镜像 的 APl， 如 图 7-38 所 示 。 


/v2/images 
Create an image 


Av2/images/ (image id} 
Show image details 





/v2/images 
Show images 





/v2/images/ [image_id} 
Update an image 


‘V2/images/ (image id 
Delete an image 





Deactivate image 


BHHHHBBBH 
= T 





Reactivate image 


单 击 “GET/v2/images” 右 侧 的 detail 按 钮 ， 会 看 到 如 图 7-39 所 示 的 提示 信息 。 


G E T f W 2 ri im d 


GET /v2/images 


把 命令 取出 如 下 : 


/v2/images/ [image id] /actions/deactivate 


v2/images/ [image idi /actions/reactivate 


图 7-38 glance API 


图 7-39 ” API 示例 


detail 


detail 












detail 


detail 


detail 


detail 









detail 








v2/images?sort=name:asc, status:desc 





查询 glance 组 件 的 服务 端口 ， 这 里 是 9292， 如 图 7-40 所 示 。 


Lroot@contro| devstack]# opens tack endpoint show glance 


十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 + 
| Field | Value | 
十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 4 


http://10. 20. 0.50: 9292 
True 


| 3darinur] | 
| enabled | 
| id | d52b3fda2c494f15a/ab9e6527b4dOO6T 
| internalurl | http://10.20.0.50:9292 

| publicurl | http://10.20.0.50:9292 

| region | RegionOne 

| service 1d | 5ab2c/b4de3941d498c0e216/700a970c 
| service name | glance 

| service type | 1 


图 7-40 ”查询 glance 的 端口 


编辑 的 Curl 命 令 如 下 : 





curl -H "X-Auth-Token: 3e36d021d04240cea03d7241576c5624" http://10.20.0.50:9292/v2/images?sort-name:asc,status:desc |python -mjson.tool 





执行 后 的 结果 如 图 7-41 所 示 。 


[rootücontrol devstack]# curl -H "X-Auth-Token:3e36d021d04240cea03d7241576c5624" http://10.20.0.50:9292/v2/images?sort=name:asc,status: 
desc |python -mjson.tool 


% Total % Received % Xferd Average Speed Time Time Time Current 
Dload Upload Total Spent Left Speed 
100 2019 100 2019 0 0 5988 0 --:--:;-- = 一 :一 -= 一 --i--:-- 6008 


"first": "/v2/images?sort=name%3Aasc%2Cstatus%3Adesc", 
Lus at [ 


"checksum" Los x» u^ cna ced. 

"container “format z 

"created_at": "2016- 10- 7111156: 03:282", 

"disk format": "ami" 

TEE "/v2/images/da4652dc- -088b-4b84-82f8-beb0976b6e25/file", 
"id": "da4652dc-088b-4b84-82f8-beb0976b6e25", 

"kerne] -id": "47792a78-437b-418b-88f8-49768ece924f" , 






"owner": E: ES eroded 4cfa90924155", 
"protected": fals 

"ramdisk id": "77d24404- 5993- -A1f0- 8011-dd8eb87 37433", 
"schema": "/v2/schemas/image 

"self": ^ / V2 /1mages /da4652dc- -088b-4b84-82f8- beb0976b6e25" , 
"size": 25165824, 

"active" 3 

tags": [], 

"updated. at" : ，2016- -10-11T16:03:292", 

"virtual  size' : null, 

"visibility": "public" 


图 7-41 返回 镜像 信息 


er 


结果 比较 多 ， 这 里 只 列 出 一 条 记录 ， 供 读者 参考 。 


API 的 练习 就 讲解 到 这 里 ， 关 于 更 多 API 的 使 用 ， 有 兴趣 的 读者 可 以 自己 去 研究 。 


7.24 ”错误 分 析 


错误 分 析 是 基于 Curl 的 ， 对 RESTClient 也 是 适用 的 。 


出 错 之 后 先 把 python-mjson.tool 去 掉 ， 防 止 过 滤 掉 错误 信息 ， 如 图 7-42 所 示 。 


[root&control devstack]# curl -H "X-Auth-Token:3e36d021d04240cea03d7241576c5624" http://10.20.0.50:9292/v2/images?sort-name:asc,status: 
desc |python -mjson.tool 


% Total % Received % Xferd Average Speed Time Time Time Current 
Dload Upload Total Spent Left Speed 
100 358 100 358 0 0 7345 Q —5:-—:—— 98 


No JSON object could be decoded 
图 7-42 json 错误 信息 
1.token id 过 期 


token id 是 有 过 期 时 间 的 ， 过 期 之 后 就 不 能 使 用 了 ， 必 须要 重新 申请 新 的 id 才 可 。 例 如 ， 同 样 的 命令 再 次 执行 时 就 报错 了 ， 如 图 7-43 所 示 。 原 因 分 析 是 token id 过 期 了 ， 需 要 重新 申请 新 的 token id, 


[rootücontrol devstack]# curl -H "X-Auth-Token:3e36d021d04240cea03d7241576c5624" http://10.20.0.50:9292/v2/images?sort-name:asc,status: 


desc 
«html» 
«head» 
<title>401 Unauthorized</title> 
</head> 
<body> 


«h1»401 Unauthorized«/h1» . 
This server could not verify that you are authorized to access the document you requested. Either you supplied the wrong credentials 


(e.g., bad password), or your browser does not understand how to supply the credentials required.«br /»«br /» 


«/body» 
«/html»[root&control devstack]# 


图 7-43 Cu 返回 认证 错误 信息 


2. 地 址 或 端口 写 错 
特别 是 初学 者 ， 经 常 不 注意 各 组 件 服务 的 端口 是 不 一 样 的 ， 筷 记 修改 就 直接 进行 实验 。 地 址 或 端口 写 错 后 的 结果 如 图 7-44 所 示 。 


[root@control devstack]# curl -H "X-Auth-Token:ec0701c1e0124a008bd0140ea6f20b61" http://192.168.0.50:9696/v2/images?sort=name:asc,stat 


us:desc 
«html» 
<head> 
<title>404 Not Found</title> 
</head> 
<body> 
<h1>404 Not Found</hi> 
Unknown API version specified<br /><br /> 


</body> 
</html>[root@control devstack]# 


图 7-44 Curl 返回 404 错 误 信 息 


常用 的 OpenStack 组 件 端口 如 表 7-2 所 示 。 


表 7-2 常用 的 OpenStack 组 件 端口 


组 件 名 称 常用 端口 服务 说 明 
keystone 35357/5000 认证 组 件 
cinder 8776 块 存储 组 件 
nova 8774 计算 组 件 
glance 9292 借 像 组 件 


neutron 9696 网 络 组 件 
swift 6000/6001/6002 对 象 存 储 组 件 


3.API 用 错 


\ 一 ZX 一 


API Mitaka 以 后 版 本 可 能 会 有 些 变 化 ， 一 定 要 按 官方 文档 上 的 说 明 进 行 测试 。API 方 法 写 错 之 后 的 运行 结果 如 图 7-45 所 示 。 


[root@control devstack]# curl -H "X-Auth-Token:ec0701cle0124a008bd0140eaó6f20b61" /v2/1mages/detail 
curl: (3) «url» malformed _ 


图 7-45 ”Curl 返回 API 匹 配 错 误 信 息 


oon 


要 保证 API 测 试 结果 正确 必须 要 有 一 个 正常 运行 的 OpenStack 环 境 ， 否则 错误 会 比较 多 ， 以 上 测试 是 在 正确 安装 DevStack 后 的 环境 中 进行 的 。 


7.3 ”OpenStack 界 面 主题 的 修改 


一 般 的 企业 建 起 OpenStack 之 后 基本 会 有 一 个 需求 一 一 修改 界面 ， 本 节 就 介绍 一 下 怎么 来 修改 logo 和 样式 .。 


7.3.1 logo 


在 登录 页 面 有 Openstack logo 的 地 方 按 右键 ， 单 击 属性 会 出 现 如 图 7-46 所 示 的 内 容 。 





openstack 


n H H 
DASHHOARB I 


logo-splash.png 


HRY : HyperText Transter Protocol 





ze : png Image 


Hait : http://10.20.0.50/dashboard/static/dashboard/img 
/logo-splash.png 


大 小 ; — 3187308 


set: 108* 了 21 pixels 


2016/10/13 





2010/10/13 
BUE FE 





在 系统 中 找到 logo 所 在 的 路 径 : /opt/horizon/static/dashboard/img. 


目录 内 容 如 图 7-47 所 示 ， 能 找到 logo-splash.png。 可 以 下 载 下 来 ， 修 改 一 下 再 传 上 去 ， 修 改 后 的 logo 如 图 7-48 所 示 。 


[root&ücontrol img]# 1s — 
firewall-gray.svg 
firewall-green.svg 


alarm-gray.gif 
alarm-gray.svg 
alarm-green.svg 
alarm-red.svg 


firewall-red.svg 
flavor-gray.gif 


keypair-gray.gif 
keypair-gray.svg 


keypair-green.svg 


keypair-red.svg 


network-red. svg 
policy-gray.gif 
policy-gray.svg 
policy-green. svg 


securitygroup-green.svg 
securitygroup-red.svg 


server-gray.gif 
server-gray.svg 


volume-gray.gif 
volume-gray.svg 
volume-green. svg 
vo lume-red. svg 


config-gray.gif flavor-gray.svg Ib-gray. gif policy-red.svg server-green.svg vpn-gray.svg 
config-gray.svg flavor-green.svg lb-gray.svg port-gray.gif server-red.svg vpn-green.svg 
config-green.svg  flavor-red.svg Ib-green.svg port-gray.svg spinner .gif vpn-red. svg 
conf ig-red.svg floatingip-gray.gif | lb-red.svg port-green.svg stack-gray. gif vpn.gif 
db-gray.gif floatingip-gray.svg port-red.svg stack-gray.svg wait-gray.gif 
db-gray.svg floatingip-green.svg  logo-splash.svg router-gray.gif stack-green. svg wait-gray.svg 
db-green. svg floatingip-red. svg logo.png router-gray.svg stack-red. svg wait-green.svg 
db-red. svg image-gray.gif logo.svg router-green.svg unknown-gray. gif wait-red.svg 
drag. png image-gray.svg network-gray.gif ^ router-red.svg unknown-gray. svg 


favicon.ico image-green.svg 


network-gray.svg securitygroup-gray.gif unknown-green.svg 
firewall-gray.gif image-red.svg 


network-green.svg securitygroup-gray.svg unknown-red.svg 


图 7-47 logo. f 


主页 logo 及 路 径 如 图 7-49 所 示 。 
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图 7-48 ”修改 logo 结 果 





E openstack 


图 invisible to admin * 
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" logo.png 
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il png Image 


地 二 : http://10.20.0.50/dashboard/static/dashboard/img 
flogo.png 


Au : 2405 ZD 





110 * 24 pixels 


ems: 2016/10/13 
修 必 时间: 2016/10/13 





图 7-49 主页 logo 及 路 径 


修改 后 的 logo 如 图 7-50 所 示 。 











图 7-50 ”主页 logo 修 改 


oor 


尽量 不 要 修改 logo 的 尺寸 ， 否则 可 能 会 引起 界面 变形 。 


7.3.2 修改 样式 


Openstack 界 面 的 修改 主要 是 样式 的 修改 ， 要 比 logo 修 改 难度 大 些 ， 本 节 讲 述 怎么 在 Openstack Mitaka 中 使 用 自己 的 样式 。 
1. 开 发 者 菜单 


Openstack Mitaka 登 录 后 界面 有 开发 者 的 菜单 ， 如 图 7-51 所 示 。 


[St 


"| ogasstack & invisible to admin + & demo * 


项 目 dL Ad 


身份 管理 要 查看 源 代 码 ， 请 使 光标 悬浮 在 某 节 上 ， 然 后 单 击 该 节 右 上 前 的 按钮 。 


SMR 


导航 条 


活动 ”链接 Tike = + piis 下 拉 菜 单 





图 7-51 ”主题 样式 修改 参考 


在 “ 缺 省 ”下 面 有 上段 文字 “要 查看 源 代码 ， 请 使 光标 悬浮 在 某 节 上 ， 然 后 单 击 该 节 右上 角 的 按钮 。， 把 光标 放 在 黑色 导航 条 的 地 方 ， 有 一 个 “</>” 标 识 ， 然 后 单 击 该 标识 符 ， 会 出 源码 的 提示 信息 ， 
如 图 7-52 所 示 。 这 里 只 提供 了 样式 参考 。 


F 


源 代 码 


¿div class="navbar navbar-inverse"- 
div class-"navbar-header"» 
¿button type="button” class-"navbar-toggle" data-toggle="collapse" data-target=".navbar-inverse-collapse"> 
<span class-"icon-bar"»«/span- 
<span class-"icon-bar"»z/span-* 
¿span class="icon-bar"></span> 
</button> 
4a classs"navbar-brand" href="#">$phe</a> 
</div> 
div class="navbar-collapse collapse navbar-inverse-collapse"> 
<ul class-"nav navbar-nav"> 
«li class="active"><a href="#"> asili» 
¿lista href="#">gphe</a></li> 
¿li class="dropdown"> 
«a href="#" class-"dropdown-toggle ng-binding" data-toggle-"dropdown"» Tig: «b class="fa fa-caret-down"></b></a> 
ul class-"dropdown-menu"- 
¿lisa href="#">gohe</a></li> 
£li»€a hrefs"4"süpei:/a»«/l11» 
£li»«a href="#"> iali 
<li class="“divider"></11> 
¿li class="dropdown-header" >ii li> 
£li»«a href="S">gohe</ar</1li> 
£li»«a href="#"> t/a li> 
</ul> 
</li> 
</ul> 


图 7-52 样式 代码 参考 
2. 自 带 主 题 


到 Openstack Mitaka 版 本 ，Horizon 可 以 在 运行 的 时 候 切 换 多 种 配置 ， 默 认 已 经 配置 了 两 种 主题 一 一 default 和 Material， 如 图 7-53 所 示 。 








Vlaterial 


[s is 


图 7-53 ”主题 列表 


单 击 Material 选 项 后 界面 如 图 7-54 所 示 。 在 些 界面 可 修改 导航 条 的 样式 。 


- 0 us n Sta ck = invisible to admin ~ 





it 
x Sn HH 
des 上 限 摘 要 
> 
映像 y 
访问 & 安全 
网 络 
实例 VCPU 数量 内 存 浮动 IP 安全 组 着 
身份 管理 已 用 0 ， 可 用 10 已 用 0 ， 可 用 20 已 用 0 ， 可 用 51200 已 用 0 ， 可 用 50 已 用 1 ， 可 用 10 已 用 0 ， 可 用 10 
图 7-54 Material 主题 
3. 自 定义 主题 


在 Material 样 式 提 示 下 ， 我 们 可 以 增加 一 个 自 定义 的 样式 “kitty”。 
(1) 复制 Material 


进入 如 下 目录 : /opt/stack/horizon/openstack dashboard/themes。 在 该 目录 下 执行 : 





cp -r material/ kitty 








oor 


-{ 是 带 权限 复制 ， 即 不 会 改变 文件 的 权限 。 
执行 结果 如 图 7-55 所 示 。 
(2) 修改 settings.py 


回 到 如 下 目录 : /opt/stack/horizon/openstack dashboard, 


[rootücontrol themes |# Is 

default kitty material 

[rootücontrol themes]£ pwd 
fopt/stack/horizon/openstack_dashboard/ themes 


编辑 settings.py 文 件 ， 增 加 如 下 内 容 : 





( 





'kitty', 

pgettext lazy("Google's Material Design style theme", "kitty"), 
'themes/kitty' 

); 














编译 后 结果 如 图 7-56 所 示 。 


# 'key', ‘label’, 'path' 
AVAILABLE THEMES - [ 


‘default’, 
pgettext lazy('Default style theme’, 'Default'), 
"themes/default' 


‘material’, 
pgettext lazy("Google's Material Design style theme", "Material"), 


‘themes /material ' 






e theme 





5 Material Design sty 





图 7-56 ”增加 kitty 内 容 


oor 


AVAILABLE, THEMES7& Ju 028 ('name', "label', 'path') ， 三 个 参数 分 别 代表 在 浏览 器 cookie 中 存储 的 值 、 菜 单 中 toggle 按 钮 的 值 、 文 件 路 径 。 
(3) 编译 压缩 

进入 如 下 目录 : /opt/stack/horizon, 

执行 如 下 命令 : 


python manage.py compress 





执行 结果 如 图 7-57 所 示 。 


[root&ücontrol horizon]£ python manage.py compress 


Found 'compress' tags in: 
fopt/stack/horizon/openstack_dashboard/temp lates/horizo 


n/ scripts.html 
/opt/stack/horizon/openstack dashboard/temp lates /hor1zo 


n/ conf.html 
/Oopt/stack/horizon/openstack dashboard/templates/ style 


sheets.html 


Compressing... done 
Compressed 6 block(s) from 3 template(s) for 3 context(s). 


图 7-57 命令 执行 结果 


(4) 重启 httpd 服 务 


重启 httpd 服 务 ， 命 令 如 下 : 





service httpd restart 





刷新 页 面 ， 查 看 是 否 有 新 添加 的 kitty 主 题 ， 如 图 7-58 所 示 。 


& demo = 
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Material 
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图 7-58 X kitty £38 


单 击 kitty， 则 会 切换 到 kitty 主 题 ， 如 图 7-59 所 示 。 


openstack = invisible to admin ~ 





闪 设置 
项 目 B us 
kitty "CEA "dba s @ 帮助 
LI ITI | = 5 s | L V 
身份 管理 
要 查看 源 代码 ， 请 车 光标 悬浮 在 某 节 上 ， 然 后 单 击 该 节 右 上 角 的 按钮 。 
开发 者 sd 
导航 条 Material 
引导 程序 主题 预览 v kitty 
isH 
D dB 
Stk d ls 
图 7-59 m Al kitty 3:58 
4. 主 题 分 析 


下 面 我 们 来 具体 认识 一 下 从 Material 复 制 过 来 的 目录 包括 哪些 内 容 ， 具 体 有 什么 作用 。 

kitty 的 目录 结构 如 图 7-60 所 示 。 

(1) static 目 录 (静态 文件 ) 

1) bootstrap 目 录 : 引入 bootstrap 目 录 ， 可 以 看 到 目录 中 包括 _styles.scss、_variables.scss。 

2) horizon 目 录 : 引入 horizon 组 件 的 静态 文件 包 。 

3) js 目录 : 引入 自 定 义 的 js 文件 。 

_styles.scss: 引入 bootstrap、horizon 目 录 中 的 样式 文件 ， 通 过 @import“bootstrap/styles; ”实现 ， 其 中 styles 指 的 是 bootstrap 目 录 中 的 _styles.scss 文 件 。 


_variables.scss: 引入 bootstrap、horizon 目 录 中 scss 定 义 的 变量 文件 ， 通 过 @import“bootstrap/variables; ”实现 ， 其 中 variables 指 的 是 bootstrap 目 录 中 的 _variables.scss 文 件 。 


[rootG@control kitty]£ tree -a 
| Static 
bootstrap 


_styles.scss 
variable customizations.scss 
_varlables.scss 
horizon 
components 
_checkboxes.scss 
_context_selection.scss 
_hamburger.scss 
_help_panel.scss 
_Magic_search.scss 
_messages.scss 
_navbar.scss 
_Sidebar.scss 
 1cons.5css 
_styles.scss 
_Varlables.scss 
15 
L— material.hamburger. 31s 
_styles.scss 
_Varlables.scss 
temp lates 
auth 
L  splash.html 
header 
brand. html 
header. html 
horizon 
L sidebar.html 


图 7-60 ”kitty 的 目录 结构 
(2) templates 目 录 (HTML 模 板 文件 ) 
1) auth 目 录 : horizon 登 录 界面 相关 的 模板 文件 。 


2) header 目 录 : horizon 内 页 header 样 式 文 件 ， 包 括 项 目 切换 等 。 


3) horizon 目 录 : 这 个 目录 包括 的 内 容 比较 多 ， 包 括 内 页 左 侧 导 航 、form 表 单 、table、model、tab 等 。 
or ee 
tree 命令 不 是 Linux 系 统 自 带 命令 ， 需 要 单独 安装 ， 安 装 命令 为 


yum install tree 





这 里 只 提供 一 个 示例 ， 修 改 一 下 导航 条 的 背景 颜色 ， 现 在 的 样式 如 图 7-61 所 示 。 


0 D e n sta Ck z invisible to admin 


图 7-61 ”要 修改 的 head 





header 的 HTML 页 面 主要 在 /themes/bruce/templates/header 目 录 下 的 header.html 文 件 中 修改 。 


编辑 header.html 文 件 ， 如 图 7-62 所 示 。 


«nav Class="navbar-inverse material-header navbar-fixed-top" 
«div class="container-fluid"> 
«l-- Brand and toggle get grouped for better mobile display --> 
<div class="navbar-header"> 





图 7-62 2&5 header.html x fF 


刷新 页 面 ， 查 看 修改 效果 ， 如 图 7-63 所 示 。 


= 0 D eC n Sta C k = invisible to admin - 





In E 





Siete 


图 7-63 ”修改 后 的 head 


这 里 只 给 出 一 个 demo， 关 于 修改 的 细节 还 需要 读者 去 研究 前 端的 代码 。 


74 ”本章 小 结 


本 章 是 OpenStack 开 发 的 入 门 内 容 ， 讲 述 了 OpenStack token、 常 用 的 APlI、API 的 使 用 、 常 用 错误 分 析 及 界面 的 简单 修改 ， 为 学 习 后 面 的 开发 内 容 葛 定 基础 。 


第 8 草 Django 框架 


Django 是 Python 最 有 代表 性 的 一 个 网 络 框 架 。 使 用 Django， 可 以 方便 地 实现 一 个 功能 全 面 、 管 理 简 便 的 网 站 或 APP 后 端 ， 本 章 针 对 Django 的 内 容 进行 讲解 。 


8.1 安装 Django 


Django 的 下 载 地 址 : https://www.djangoproject.com/download/。 目 前 Django 的 最 新 版 本 是 1.10.2， 如 图 8-1 所 示 。 


How to get Django Support Django! 


Sal Cangeloso donated to the Django 


of Python 3. The last version to support Python 2.7 is Django 1.11 LTS. See the FAO for the 


Python versions supported by each version of Django. Here's how to get it: 


Software Foundation to support Django 


Django is available open-source under the BSD license. We recommend using the latest version rr 





development. Donate today! 


Option 1: Get the latest official version Mini d 


* Latest release: Django-1.11 7.tar.gz 
Checksums: Django-1.11.7.checksum.txt 
Release notes: Online documentation 


The latest official version is 1.11.7. Read the 1.11.7 release notes, then install it with pip: 


ip install Django--1.11.7 
pps " Djang 13 * Preview release: Django-2.0rc1.tar.gz 


Checksums: Django-2 Orc1.checksum.txt 
Release notes: Online documentation 


图 8-1 Django F RA dg 


下 载 Django 安 装 包 并 解压 后 ， 打 开 cmd 命 令 行 进入 Django 目 录 ， 执 行 命令 : 





python setup.py install 





或 直接 执行 : 





pip install Django--1.10.2 或 
easy install Django 


oor 


A DUK Feasy_install RA A Django, ARRMPRALAH, — E RIO Sp RIA MRAM Django. 





1. 在 Windows 下 安装 Django 
(1) Python 包 安 装 命令 
easy_install 和 pip 都 是 用 来 下 载 安装 Python 一 个 公共 资源 库 PyPI 的 相关 资源 包 的 。 


首先 安装 easy_install， 下 载 地 址 为 https://pypi.python.org/pypi/ez_ setup。 解 压 后 如 图 8-2 所 示 。 


| Git CMD 


强 动 器 D HAS s 
+ Hel sae AGAS-E436 
D: \book\\ez_setup-0.9\\ez_setup-0.9 的 目录 


2016/10/17 13:30 <DIR> 
2016/10/17 13:30 <DIR> os 
2016/10/17 13:30 396,609 distribute-0.6.14.tar. 
2010/11/23 08:04 15,757 distribute_setup. py 
2016/10/17 11:49 <DIR> ez_setup.egg-into 
08:04 ,75/ ez setup.py 
0/:56 36 MANIFEST.1n 
08:06 2 NEWS5.txt 
14:12 PKG-INFO 
08:13 README.rst 
14:12 setup.cfg 
06:12 1,018 setup.py 
9 4A 432, 628 Ei 
3 个 目录 1,281,961, 775, 104 可 用 字 节 


D: \book\\ez_setup-0. 9\ez_setup-0. 9>_ 





图 8-2 easy install 目录 内 容 


安装 命令 如 下 : 


python ez setup.py 





安装 完成 之 后 如 图 8-3 所 示 。 


E Git CMD 


copying distribute.egg-infoXzip-sate -> bul ld\baist.win32\egg\EGG-INFO 
creating dist 
creating 'distidistribute-0.6.14-py2.7.egg' and adding ‘build\bdist.win32\egq’ t 
o 1t 
removing ‘build\bdist.win32\egg' (and everything under it) 
Processing distribute-0.6.14-py2.7.egg 
ana un ci \python27\\lib\site-packages \distribute-0.6.14-py2.7.egqg' (and everyt 
Ing under 1t 
:\python27\lib\site-packages \distribute-0.6.14-py2.7.egqg 
distribute- 0.6.14-py2.7.egg to c:Npython27XlibXsite-packages 
0.6.14 1s already he’ active version in easy-install.pth 
easy 1nstall- Aser qt. py script to C:\Python2/\Scripts 
easy install.exe script to C:\Python2/\Scripts 
easy install-2.7-script.py Ta to C:\Python27\Scripts 
] easy install-2.7.exe script to C:\Python?2/\Scripts 


Installed c:\python27\lib\site-packages\distribute-0.6.14-py2.7.egq 
Processing dependencies for distribute--0.6.14 
Finished processing dependencies for distribute--0.6.14 

After install bootstrap. 

:\Python27\\Lib\site-packages \setuptools-0.6cll-py2.7.eqg-info already exists 


D:\book\ez_setup-0.9\ez_setup-0. 9> 





图 8-3 ”安装 完成 


设置 环境 变量 ， 如 图 8-4 所 示 。 


Path 


cmd;C: SPythonzT;DC: SPythonZT*Seriptz 





图 8-4 设置 环境 变量 


安装 好 easy install 之 后 再 安装 pip : 





easy install install pip 








也 可 以 下 载 之 后 使 用 命令 安装 ， 下 载 地 址 为 https://pypi.python.org/pypi/pip。 


下 载 后 解压 ， 安 装 命令 如 下 : 





python setup.py install 





pip 的 验证 如 图 8-5 所 示 。 


B' Git CMD 


\ez_setup-0.9>pip 


pip <command> [options] 


ommands : 

instal | Install packages. 

down load Download packages. 

uninstall Uninstall packages. 

freeze Qutput installed packages in requirements format. 
list List installed packages. 

show Show information about installed packages. 
search Search PyPI for packages. 

whee | Build wheels from your requirements. 

hash Compute hashes of package archives. 
completion A helper command used for command completion 
help Show help for commands. 


eneral Options: 
-h, --help Show help. 
--1solated Run pip in an isolated mode, ignoring 
environment variables and user configuration. 
-y, --verbose Give more output. Option 1s additive, and can 





图 8-5 ”pip 的 验证 


(2) 查询 安装 版 本 
查询 安装 DevStack 的 Django 版 本 ,命令 如 下 : 


[root@controldevstack]# pip list |grepDjango 
Django (1.8.10) 








(3) 安装 Django 


直接 指定 安装 1.8.10 版 本 ， 命 令 如 下 : 


pip install Django==1.8.10 





Django 的 安装 过 程 如 图 8-6 所 示 。 
B' Git CMD 


D:Xbook*yez setup-0.9Xez setup-0.9»pip install Django--1.8.10 

ollecting Django--1.8.10 

APython27 V ib site-packages \pip-8.1.2-py2.7.egg\pip\_vendor \requests packages \ 
url 1ib3\util\ssl_ .py:318: SNIMissingWarning: An HTTPS request has been made, but 
the SNI (Subject Name Indication) extension to TLS 1s not available on this pla 
form. This may cause the server to present an incorrect TLS certificate, which 
can cause validation failures. You can upgrade to a newer version of Python to 5 
olve this. For more information, see https://urllib3.readthedocs.org/en/latest/s 
ecurity.html#snimissingwarning. 

SNIMissingwWarning 

:\Python27\ lib\site-packages \pip-8.1.2-py2.7.egg\pip\_vendor \requests \packages \ 
url 1ib3\util\ss1_ .py:122: InsecurePlatformWarning: A true SSLContext object 1s n 
ot available. This prevents urllib3 from configuring SSL appropriately and may c 
ause certain SSL connections to fail. You can rade to a newer version of Pyth 
on to solve this. For more information, see https://urllib3.readthedocs.org/en/ | 
atest/security.html£insecureplatformwarning. 

InsecureP latformwarning 

Using cached Django-1.8.10-py2.py3-none-any.wh| 
Install1 collected packages: Django 
succesfully installed Django-1.8.10 





D: \book\,ez_setup-0. 9\\ez_setup-0. 9> 


oe 

也 可 以 通过 Git 来 下 载 Django。 
(4) Django 验 证 

1) 通过 执行 pip 命 令 查看 : 


pip list 


A8-6 指定 安装 版 本 





命令 执行 后 如 图 8-7 所 示 。 


| Git CMD 


: ok \ez_setup-0.9\ez7_setup-0.9>pip 
trie (0.6.14) 
Django n 8.10) 


pip (8.1.2) 
setuptools (0.6rc11) 


D:XbookXez setup-0.9*Mez setup-0.9- 


图 8 


2) 通过 Python 导入 模块 来 验证 安装 版 本 是 不 是 1.8.10， 如 图 8-8 所 示 。 


E| Git CMD - nho 


ez_setup-0.9>pyt 


-7 查看 Python 包 列 表 





oook ytho 5 
python 2.7.5 (default, May 15 2013, 22: :43: 36) [MSC v.1500 32 bit (Intel)] on win 


. copyright", "credits" 


r "license" 


图 8-8 导入 Django 模 块 


Oi 
pip 默 认 安 装 的 是 最 新 版 本 。 
(5) Django 


(1) pip 印 载 。 某 些 情况 下 需要 和 镍 载 已 经 安装 的 Django 包 ， 命 令 及 结果 可 以 参考 图 8-9。 


for more information. 





a Git CMD 
: Apython27M lib\site-packages \dj]ango \v1ews generic Init 
:\python27\ lib\site-packages\django\views \generic\__init__ 
:Apython27 lib\site-packages \dj]ango\v1ews \generic\base. py 
: \python2?7\ lib\site-packages \django\views \generic\base. pyc 
:\python27\ lib\site-packages \django\views \generic\dates.py 
:\python27\ lib\site-packages \django\views \generic\dates.pyc 
:Apython27 lib\site-packages \django\views \generic\detat | .py 
: \python2?7\ lib\site-packages \django\views \generic\detat |. pyc 
:Apython27* lib\site-packages \django\views \generic\edit.py 
:\python27\ lib\site-packages \django\views \generic\edit.pyc 
:\python27\ lib\site-packages \django\views \generic\ list.py 
: \\python2?7\ lib\site-packages \django\views \generic\ list.pyc 
: \python27\ lib\site-packages \django\views \118n. py 
:\\python27\lib\site-packages \django\views\118n. pyc 
:Apython27 lib\site-packages\django\views \static. py 
:\python2?7\ lib\site-packages \django\views \static. pyc 
:\python27\scripts\django-admin.exe 
:\python27\scripts\django-admin. py 

c: \python?7\scripts \django-admin. pyc 
Proceed (y/n)? y 

Successtully uninstalled Django-1.8.10 


C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 
C 


D:XbookXez setup-0.9*Mez setup-0.9»pip uninstall Django 





图 8-9 #p Django & 


2) easy install, easy installi&Udxáp S n FB: 





easy install -mxNPackageName 





2. 在 Linux 等 系统 下 安装 Django 


如 果 使 用 DevStack， 已 经 安装 好 了 Django， 如 图 8-10 所 示 。 


[root@control devstack]£ pip list |grep Django 
Django (1.5.10) 
图 8-10 dif Django & 
如 果 没 有 安装 可 以 参考 Windows 系 统 下 的 安装 过 程 。 
3. 安 装 数据 库 软 件 (MySQL) 


学 习 Django 会 用 到 数据 库 ， 本 教材 使 用 的 是 MySQL，Windows 用 户 可 自行 安装 ，MySQL 下 载 地 址 为 http://dev.mysdl.com/downloadsyVinstaller/。 


8.2 Django 的 架构 


Django 的 MTV 模 式 本 质 上 和 一 般 MVC 是 一 样 的， 也 是 为 了 各 组 件 间 保 持 松 耦 合 关系 ， 只 是 在 定义 上 有 些许 不 同 。Django 的 MTV 如 表 8-1 所 示 。 


表 8-1 Django 的 MTV 


意义 说 明 
M 代表 模型 ( Model) ff vi MY FS AT AeA BTA PERS ASI (ORM) 
T 代表 模板 (Template) 负责 如 何 把 页 面 展示 给 用 户 (HTML) 
V 代表 视图 (View) 负责 业务 逻辑 ， 并 在 适当 时 候 调 用 Model 和 Template 


除了 以 上 三 层 之 外 ， 还 需要 一 个 URL 分 发 器 ， 它 的 作用 是 将 一 个 个 URL 的 页 面 请 求 分 发 给 不 同 的 视图 处 理 ， 视 图 再 调用 相应 的 数据 模型 和 模板 。MTV 的 响应 模式 如 图 8-11 所 示 。 





URL 


— iik — ”中 间 件 D 
分 发 天 





<< ii] Io? 


图 8-11 MTV 的 响应 模式 


1) Web 服 务 器 (中 间 件 ) 收 到 一 个 HTTP 请 求 。 

2) Django 在 URLconf 里 查找 对 应 的 视图 (View) 为数 来 处 理 HTTP 请 求 。 

3) 视图 函数 调用 相应 的 数据 模型 来 存 取 数 据 ， 调 用 相应 的 模板 向 用 户 展示 页 面 。 

4) 视图 函数 处 理 结束 后 返回 一 个 HTTP 的 响应 给 Web 服 务 器 。 

5) Web 服 务 器 将 响应 发 送 给 客户 端 。 

这 种 设计 模式 的 关键 优势 在 于 各 种 组 件 都 是 松 耦合 的 。 这 样 ， 每 个 由 Django 驱 动 的 Web 应 用 都 有 着 明确 的 目的 ， 并 且 可 独立 更 改 而 不 影响 其 他 部 分 。 


例如 ， 开 发 者 更 改 一 个 应 用 程序 中 的 URL 而 不 影响 这 个 程序 底层 的 实现 ;设计 师 可 以 改变 HTML 页面 的 样式 而 不 用 接触 Python 代码 ;数据 库 管理 员 可 以 重 命名 数据 表 并 且 只 需 更 改 模型 ， 无 须 从 一 大 堆 
文件 中 进行 查找 和 蔡 换 。 


Django 的 MTV 模 式 相对 应 的 Python 文件 如 图 8-12 所 示 。 


request reponse url.py 


Template 


model.py 





图 8-12 ”Django 的 MTV 模 型 相对 应 的 Python 文件 


8.3 ”创建 项 目 


Django 是 Openstack Horizon 的 基础 框架 ， 下 面 就 开始 学 习 Django 编 程 ， 本 节 代 码 是 在 Dev 的 tack 上 完成 的 。 


8.31 ”Django 管理 工具 


django-admin.py 是 Django 的 一 个 用 于 管理 任务 的 命令 行 工 具 。 输 入 django-admin.py 会 得 到 相关 信息 如 下 : 


# django-admin.py 
Type 'django-admin.py help <subcommand>' for help on a specific subcommand. 
Available subcommands: 
[django] 
check 
compilemessages 
createcachetable 
dbshell 
diffsettings 


























dumpdata 
flush 
inspectdb 
loaddata 
makemessages 
makemigrations 
migrate 
runfcgi 
runserver 
shel] 
showmigrations 
sql 
sqlall 
sqiclear 
sqicustom 
sqldropindexes 
sqlflush 
sqlindexes 
sqlmigrate 
sqlsequencereset 
squashmigrations 
startapp 
startproject 
syncdb 

test 
testserver 
validate 



























































系统 帮助 功能 的 使 用 示例 如 下 : 





# django-admin.py help sql 

















usage: django-admin.py sql [-h] [--version] [-v {0,1,2,3}] 
[--settings SETTINGS] [--pythonpath PYTHONPATH] 
[--traceback] [--no-color] [--database DATABASE] 














I 


app label [app label http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/...] 
































Prints the CREATE TABLE SQL statements for the given app name(s). 








positional arguments: 
app label One or more application label. 





optional arguments: 
-h, --help show this help message and exit 
--version show program's version number and exit 
-v (0,1,2,3), --verbosity {0,1,2,3} 
Verbosity level; O=minimal output, 1-normal output, 
2=verbose output, 3-very verbose output 
--settings SETTINGS The Python path to a settings module, e.g. 
"myproject.settings.main". If this isn't provided, the DJANGO SETTINGS MODULE environment variable will be used. 
--pythonpath PYTHONPATH a i 







































































A directory to add to the Python path, e.g. 
"/home/djangoprojects/myproject". 
--traceback Raise on CommandError exceptions 
--no-color Don't colorize the command output. 
--database DATABASE Nominates a database to print the SQL for. Defaults to 


the "default" database. 
or oe 


不 同 的 版 本 ， 内 容 可 能 会 有 差异 。 












































使 用 下 面 的 命令 创建 项 目 : 





django-admin.py startproject mysite 


执行 以 上 命令 之 后 便 会 在 当前 目录 下 看 到 新 建 的 项 目 ， 项 目 目 录 结 构 如 图 8-13 所 示 。 


rootücontrol opt]# tree mysite/ 
mysite/ 
manage. py 
mysite 
__ init__.py 
settings.py 
urls.p 


wsg1i.py 


1 directory, 5 files 





图 8-13 ”项目 目录 结构 


8.3.2 ”测试 站 点 


manage.py 是 对 django-admin.py 的 简单 包装 ， 每 个 Django Project 里 面 都 会 包含 一 个 manage.py。 


在 命令 行 中 输入 cd， 进 入 新 建 的 项 目 文 件 夹 ， 执 行 命令 : 
manage.py runserver 8080 


默认 访问 地 址 是 127.0.0.1， 这 里 加 上 IP 地 址 ， 命 令 及 执行 后 如 图 8-14 所 示 。 


[rootücontrol mysite|]# ./manage.py runserver 10.20.0.50:5080 
Performing system checks... 


System check identified no issues (0 silenced). 


You have unapplied migrations; your app may not work properly until they are applied. 


Run ‘python manage.py migrate’ to apply them. 

October 11, 2016 - 22:21:05 | 

Django version 1.8.10, using settings 'mysite.settings' 
Starting development server at http: //10.20.0.50:8080/ 
Quit the server with CONTROL -C. 


图 8-14 启动 项 目 


将 10.20.0.50: 8080 地 址 复制 到 浏览 器 中 ， 则 可 进入 访问 页 面 ， 如 图 8-15 所 示 。 


36022 ll ER 8.1 
© € C @ ® U http//10.20.0.50 Ptv 


|> © Welcome to Djangc | + 


It worked! 


Congratulations on your first Django-powered page. 


Of course, you haven t actually done any work yet. Next, start your first app by running python manage. py startapp [app label]. 


You re seeing this message because you have DEBUG = True in your Django settings file and you haven t configured any URLs. Get to work! 


图 8-15 访问 页 面 


oon 


虽然 有 一 个 运行 的 服务 器 ， 但 还 没有 内 容 ; 还 需要 放 开 8080 的 防火 墙 端 口 ， 否则 访问 页 面 可 能 会 超时 。 

下 面 来 创建 第 一 个 页 面 。 从 HTTP 协 议 中 可 以 看 到 ， 网 络 服务 器 是 “请 求 - 回 应 ”的 工作 模式 。 客 户 向 URL 发 送 请 求 ， 服 务 器 根据 请 求 处 理 后 返回 给 用 户 。 
将 URL 对 应 分 配给 某 个 对 象 处 理 ， 这 需要 在 mysite/mysite 下 的 urls.py 设 定 。Python 会 根据 该 程序 ， 将 URL 请 求 分 给 某 个 对 象 。 

对 urls.py 修 改 如 下 : 


from django.conf.urls import patterns, include, url 








from django.contrib import admin 
admin.autodiscover () 








urlpatterns - patterns('', 
# Examples: 
# url(r'^$', 'mysite.views.home', name="home'), 
# url(r'^blog/', include('blog.urls')), 








url(r'^admin/', include (admin.site.urls)), 
url(r'^$', 'mysite.views.first page'), 














最 后 一 行 的 作用 是 将 根 目录 的 URL 分 配给 一 个 对 象 进行 处 理 ， 这 个 对 象 是 mysite.views.first_page。 


用 以 处 理 HTTP 请 求 的 这 一 对 象 还 不 存在 ， 需 要 在 mysite/mysite 下 创建 views.py， 并 在 其 中 定义 first_page 函 数 : 








# -*- coding: utf-8 -*- 


from django.http import HttpResponse 








def first page (request): 
return HttpResponse ("<p> 中 国 好 </p>") 

















第 一 行 说 明 字符 编码 为 utf-8， 为 下 面 使 用 中 文 做 准备 。first_page 遂 数 的 功能 是 返回 HTTP 回 复 ， 即 这 里 的 “<p> 中 国 好 </p>”。first_page 有 一 个 参数 request， 该 参数 包含 请 求 的 具体 信息 ， 如 请 求 


的 类 型 等 ， 这 里 暂时 没有 用 到 。first_page 页 面 效 果 如 图 8-16 所 示 。 


Naess 


€ CQ @ Ww 9 hitp://10.20.0.50: 


|> 10.20.00, 508080 T 


中 国 好 








图 8-16 first_page 页 面 效 果 


8.3.3 ”增加 一 个 APP 


一 个 网 站 可 能 有 多 个 功能 。 可 以 在 Diango 下 ， 以 APP 为 单位 实现 模块 化 管理 ， 而 不 是 将 所 有 的 东西 都 放 到 一 个 文件 夹 中 。 在 mysite 下 运行 manange.py， 创 建新 的 APP : 





python manage.py startapp app test 


命令 执行 后 ，app_test 目 录 结 构 如 图 8-17 所 示 。 


[rootücontrol mysite|# tree app test/ 
app. test/ 

admin.py 

Nt .py 

migrations 

L— init__.py 

models.py 

tests.py 

v1ews.py 


1 directory, 6 Tiles 


图 8-17 app test E R254 


这 个 新 的 APP 称 作 app_test， 还 需要 修改 项 目 设 置 。 要 使 用 app_test， 需 要 在 mysite/setting.py 的 INSTALLED_ APPS 原 组 中 增加 app_test : 


INSTALLED APPS = ( 
'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 
'app test', 





























可 以 看 到 ， 除 了 新 增加 的 app_test，Django 已 经 默认 加 载 了 一 些 功能 性 的 APP， 如 用 户 验 证 、 会 话 管理 、 显 示 静 态 文 件 等 ， 将 在 以 后 讲解 它们 的 用 途 。 
下 面 为 APP 增 加 首页 。 之 前 在 mysite/urls.py 中 设置 的 URL 访 问 对 象 依然 采用 类 似 的 方式 设置 。 另 一 方面 ， 实 现 模块 化 ， 应 该 在 app_test/urls.py 中 设置 URL 访 问 对 象 。 具 体 如 下 。 
1. 修 改 mysite/urls.py 


from django.conf.urls import patterns, include, url 











from django.contrib import admin 
admin.autodiscover () 





urlpatterns - patterns('', 
# Examples: 
# url(r'^$', 'mysite.views.home', name="home'), 
# url(r'^blog/', include('blog.urls')), 








url(r'^admin/', include(admin.site.urls)), 
url(r'^$', 'mysite.views.first page'), 
url(r'^app test/', include('app test.urls')), 

















注意 最 后 一 行 。 对 于 app_test/ 的 访问 ， 可 参考 app_test/urls.py。 
2. 创 建 app_test/urls.py 


添加 如 下 内 容 : 














from django.conf.urls import patterns, include, url 





urlpatterns - patterns('', 
url(r'^$', 'app test.views.first page'), 





) 





将 URL 对 应 到 app_test 下 的 views.py 中 的 first page 国 数 (参考 上 面 的 first page) . 


访问 http://10.20.0.50:8080/app_test， 效 果 如 图 8-18 所 示 。 


GW http;//10.20.0.50 





I> | © | 1020.0.50:8080/app test; | + 


ui 


图 8-18 app test B 2574 


这 样 ， 添 加 首页 就 完成 了 ， 可 见 Django 的 创建 过 程 还 是 比较 简单 的 。 


8.4 使 用 数据 库 


一 个 没有 数据 库 的 网 站 ， 所 能 提供 的 功能 会 非常 有 限 。 本 节 讲 解 MySQL 的 使 用 。 


8.4.1 连接 数据 库 


连接 数据 库 的 密码 写 在 DevStack 部 署 时 的 local.conf 文 件 中 ， 如 图 8-19 所 示 。 


# If the * PASSWORD variables are not set here you will be prompted to enter 
# values for them by stack.sh and they will be added to local.conf . 
ADMIN. PASSWORD-12 3456 


WATABASE PASSWORD-stackdb 
RABBIT. PASSWORD-stackqueue 
SERVICE. PASSWORD-$ADMIN. PASSWORD 





图 8-19 ”数据 库 密 码 
登录 验证 ， 如 图 8-20 所 示 。 


[rootiücontrol mysite]£ mysql -u root -pstackdb 

Welcome to the MariaDB monitor. Commands end with ; or \a. 
Your MariaDB connection id is 166 

Server version: 10.1.1/-MariaDB MariaDB Server 


Copyright (c) 2000, 2016, Oracle, MariaDB Corporation Ab and others. 
Type 'help;' or 'Xh' for help. Type 'Nc' to clear the current input statement. 
MariaDB [ (none) ]> 
图 8-20 登录 MySQL 数 据 库 
Django 为 多 种 数据 库 后 台 提 供 了 统一 的 调用 APl。 根 据 需求 不 同 ，Django 可 以 选择 不 同 的 数据 库 后 台 。MySQL 是 最 常用 的 数据 库 ， 也 是 OpenStack 使 用 的 数据 库 ， 这 里 将 Django 和 MySQL 连 接 。 


在 MySQL 中 创立 Django 项 目的 数据 库 : 











MariaDB [(none)]» CREATE DATABASE django DEFAULT CHARSET-utf8; 
Query OK, 1 row affected (0.07 sec) 















































这 里 使 用 utf8 作 为 默认 字符 集 ， 以 便 支 持 中 文 。 


在 MySQL 中 为 Django 项 目 创立 用 户 ， 并 授予 相关 权限 : 
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MariaDB [(none)]» GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, EX, ALTER, EMPORARY TABLES, LOCK TABLES ON django.* TO 'test'@'localhost' ID 


ENTIFIED BY 





























Query OK, 0 rows affected (0.15 sec) 


登录 验证 ， 如 图 8-21 所 示 。 


在 settings.py 中 ， 将 DATABASES 对 象 更 改 为 : 






































DATABASES = { 
'default': 
'ENGINE': 'django.db.backends.mysql', 
'NAME': 'django', 
'USER': 'test', 
' PASSWORD' 'test', 
'HOST':'localhost', 
"PORT':'3306'; 








[rootücontrol mysite]# mysql -u test -ptest 

welcome to the MariaDB monitor. Commands end with ; 
Your MariaDB connection id is 1/0 

Server version: 10.1.1/-MariaDB MariaDB Server 


or \g. 


Copyright (c) 2000, 2016, Oracle, MariaDB Corporation Ab and others. 
Type 'help;' or 


MariaDB [ünone)]- 


图 8-21 新 用 户 登录 


台数 据 库 类 型 为 MySQL。 上 面 程序 包含 数据 库 名 称 和 用 户 的 信息 ， 它 们 与 MySQL 中 对 应 的 数据 库 和 用 户 的 设置 相同 。Django 根 据 这 一 设置 ， 与 MySQL 中 相应 的 数据 库 和 用 户 连接 起 来 。 此 


'test'; 


"hh" for help. Type 'Nc' to clear the current input statement. 


后 ，Django 就 可 以 在 数据 库 中 读 写 了 。 


8.4.2 创 


MySQL 是 关系 型 数据 库 ， 在 Django 的 帮助 下 ， 可 以 不 用 直接 编写 SQL 语句 ; Django 将 关系 型 的 表 (table) 转换 成 为 


VIRE 


可 以 





每 个 记录 (record) 是 该 类 下 的 一 个 对 象 (object) 。 


使 用 基于 对 象 的 方法 来 操纵 关系 型 的 MySQL 数 据 库 。 


在 传统 的 MySQL 中 ， 数 据 模型 是 表 。 在 Django 下 ， 一 个 表 为 


表 的 每 一 列 是 该 类 的 一 个 属性 。 在 models.py 中 ， 我 们 创建 一 个 只 有 一 列 的 表 ， 即 只 有 一 个 属性 的 类 








from django.db import models 


class Character (models.Model): 








name = models.CharField (max length-200) 
def unicode (self): 
return self.name 





类 Character 定 义 了 数据 模型 ， 它 需要 继承 自 models.Model。 在 MySQL 中 ， 这 个 类 实际 上 是 一 个 表 。 表 只 有 一 列 ， 即 name。 可 以 看 到 ，name 属 性 是 


类 Character 有 一 个 _unicode_() 方法 ， 用 来 说 明 对 象 的 字符 表达 方式 。 对 于 Python3， 可 定义 str. () 方法 ， 实 现 相同 的 功能 。 


Django 根 据 models.py 中 描述 的 数据 模型 ， 在 MySQL 中 真正 地 创建 各 个 关系 表 : 


# python manage.py syncdb 


























/usr/lib/python2.7/site-packages/django/core/management/commands/syncdb.py:24: RemovedInDjangol9Warning: The syncdb command will be removed in Django 1.9 
warnings.warn("The syncdb command will be removed in Django 1.9", RemovedInDjangol 9Warning) 

Operations to perform: 
Synchronize unmigrated apps: staticfiles, messages 
Apply all migrations: admin, app test, contenttypes, auth, sessions 








Synchronizing apps without migrations: 

Creating tableshttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
Running deferred SQLhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
Installing custom SQLhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
Running migrations: 






































































































































































































































































































































































































































Rendering model stateshttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... DONE 
Applying pg nm x A D Lc qu in OK 
Applying auth.0001 initialhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/.. E 
Applying admin.0001 initialhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/.. 
Applying app test.0001 initialhttp://www.hzcourse. nn ne T bk 
Applying contenttypes.0002 remove content type namehttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17 14/OEBPS/Text/... OK 
Applying auth.0002 alter "permission name max lengthhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... OK 
Applying auth.0003 alter user email max lengthhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... OK 
Applying auth.0004 alter user username optshttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... OK 
Applying auth.0005 alter user last login nullhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... OK 
Applying auth.0006 require contenttypes 0002http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... OK 
Applying sessions.0001 initialhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... OK 

You have installed Django's auth system, and don't have any superusers defined. 


Would you like to create one now? (yes/no): 
Username (leave blank to use 'root'): 

Email address: root@root.com 

Password: 

Password (again): 

Superuser created successfully. 


oon 


APZ (root) 及 密码 (123456) 在 后 面 的 管理 页 面 会 用 到 。 


yes 























至 此 ， 数 据 模型 创立 完成 。 打 开 MySQL 命 令 行 : 


Smysal -u test -ptest 





查看 数据 模型 ， 如 图 8-22 所 示 。 


MariaDB [(none)]- use django 
Reading table information for completion of table and column names 
You can turn off this feature to get a quicker startup with -A 


Database changed 
MariaDB [django]> show tables; 


app test character 
auth group 

auth group permissions 
auth. permission 

auth user 

auth user groups 

auth user user permissions 
django admin log 
django content type 
django migrations 
django session 


+ 一 一 一 一 一 一 一 一 一 一 一 + 一 二 


11 rows in set (0.01 sec) 


图 8-22 ”查看 Django 库 所 有 表 


如 果 看 不 到 app_test_character 的 表 ， 可 以 执行 如 下 命令 : 





[root@control mysite]# Python manage.py makemigrations 
Migrations for 'app test': 
0001 initial.py 
- Create model Character 








#python manage.py migrate 
Operations to perform: 
Synchronize unmigrated apps: staticfiles, messages 

















Apply all migrations: admin, app test, contenttypes, auth, sessions 
Synchronizing apps without migrations: 
Creating tableshttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
Running deferred SQLhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
Installing custom SQLhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
Running migrations: i 
Rendering model stateshttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... DONE 
Applying app test.0001 initialhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... OK 


























































































































查询 character 的 表 结 构 ， 如 图 8-23 所 示 。 


MariaDB Ldjangol> show columns from app test character; 


十 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 rd 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 
| Field | Type | Null | Key | Default | Extra | 
十 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 + 


| id | int C11) | NO | PRI | NULL | auto. increment | 
| name | varcharCebo) | NO | | NULL | | 


J rows in set (0. 00 cd 
图 8-23 ”显示 表 的 字段 


可 以 看 到 ，Django 还 自动 增加 了 一 个 id 列 ， 作 为 记录 的 主键 (primary key) 。 


8.4.3 ”显示 记录 


数据 模型 虽然 建立 了 ， 但 还 没有 数据 输入 。 为 了 简便 ， 我 们 手动 添加 记录 。 打 开 MySQL 命 令 行 ， 并 切换 到 相应 数据 库 。 添 加 记录 : 











NSERT INTO app test character (name) Values ('zhangs1'); 
NSERT INTO app test character (name) Values ('lisi2'); 
NSERT INTO app test character (name) Values ('wangwu3'); 















































查询 记录 ， 如 图 8-24 所 示 。 可 以 看 到 ， 三 个 名 字 已 经 录入 数据 库 。 


Mar1aDB idjango]> select * from app_test_character; 


| 1 | zhangsl | 
| 2 | lsi? | 
| 3 | wangwu3 | 


3 rows in Me (0. 00 sec) 


图 8-24 显示 表 的 内 容 
下 面 通过 代码 从 数据 库 中 取出 数据 ， 并 返回 给 HTTP 请 求 。 在 app_test/views.py 中 添加 视图 ， 将 从 数据 库 中 读 取 所 有 的 记录 ， 然 后 返回 给 客户 端 。 


# -*- coding: utf-8 -*- 





from django.http import HttpResponse 








from app test.models import Character 








def all (request): 

















all list = Character.objects.all() 
all str = map(str, all list) 
return HttpResponse ("<p>" + ' '.join(all str) + "</p>") 





可 以 看 到 ， 从 app_test.models 中 引入 了 Character 类 。 通 过 操作 该 类 ， 我 们 可 以 读 取 表格 中 的 记录 ， 为 了 让 HTTP 请 求 能 找到 上 面 的 程序 ， 在 app_test/urls.py 增 加 URL 导 航 : 








from django.conf.urls import patterns, include, url 





urlpatterns - patterns('', 
url(r'^all/', 'app test.views.all'), 
) 


运行 服务 器 。 在 浏览 器 中 输入 URL: 10.20.0.50:8080/app_test/all/。 查 看 效果 ， 如 图 8-25 所 示 。 


160 Sal Se 8.1 


€ el t fr 9 http://10.20.0.50:E 

















[> Cc 10.20.0.50:8080/app test/all) | + 


ghangsl lisiz wanzwu3 


图 8-25 ”显示 数据 库 的 内 容 


Django 使 用 类 和 对 象 接口 来 操纵 底层 的 数据 库 。 


8.5 模板 


本 节 将 介绍 如 何 把 显示 的 内 容 放 在 模板 中 。 


8.5.1 使 用 模板 


使 用 一 个 独立 的 templay.html 文 件 作为 模板 ， 将 它 放 在 templates/app_test/ 文 件 夹 下 。 文 件 系 统 的 结构 如 图 8-26 所 示 。 


templay.html 文 件 的 内 容 如 下 : 





<h1>{{ label }}</h1> 


[rootücontrol templates]£à tree 


L— app. test 
—— templay.html 


1 directory, 1 file 


图 8-26 | X templates A RAS 
可 以 看 到 ， 这 个 文件 中 有 一 个 用 双 括 号 引起 来 的 变量 ， 这 就 是 未 来 数据 要 出 现 的 地 方 。 相 关 的 格式 控制 ， 即 <h1> 标 签 ， 则 已 经 标明 在 该 模板 文件 中 。 


需要 向 Django 说 明 模板 文件 的 搜索 路 径 ， 修 改 mysite/settings.py， 添 加 如 下 内 容 : 





# Template dir 
TEMPLATE DIRS = ( 
os.path.join(BASE DIR, 'templates/app test/'), 
































) 





如 果 还 有 其 他 路 径 用 于 存放 模板 ， 可 以 增加 该 元 组 中 的 元 素 ， 以 便 Django 可 以 找到 需要 的 模板 。 


现在 修改 app_test/views.py， 增 加 一 个 新 的 对 象 ， 用 于 向 模板 提交 数据 : 





# -*e coding: ntf-8 -*- 








#from django.http import HttpResponse 
from django.shortcuts import render 

















def templay (request): 
context- {} 
context['label'] = 'Hello World!' 
return render (request, 'app test/templay.html', context) 




















可 以 看 到 ， 这 里 使 用 render 来 替代 之 前 使 用 的 HttpResponse。render 还 使 用 了 一 个 词典 context 作 为 参数 ， 这 就 是 获取 的 数据 。 
context 中 元 素 的 键 值 为 label， 正 对 应 刚才 的 变量 的 名 字 。 这 样 ， 该 context 中 的 label 元 素 值 就 会 填 上 模板 里 的 “ 坑 ” ， 构 成 一 个 完整 的 HTTP 回 复 。 
练习 : 自行 修改 app_test/urls.py， 让 http://10.20.0.50:8080/app_test/templay 的 URL 请 求 可 以 找到 相应 的 view 对 象 。 


访问 http://10.20.0.50:8080/app_test/templay， 可 以 看 到 如 图 8-27 所 示 的 页 面 。 





€ 人 全 二 http://10.20.0.50:8080/app test/te 


I^ | © | 1020.0.50:8080/app test/templa, | + 


Hello World! 


图 8-27 显示 templates 目 录 内 容 


8.5.2 ”流程 分 析 


回顾 一 下 整个 流程 : appP_test/views.py 中 的 templay () 在 返回 时 ， 将 环境 数据 context 传 递 给 模板 templay.html。Django 根 据 context 元 素 中 的 键 值 ， 将 相应 数据 放 入 模板 中 的 对 应 位 置 ， 生 成 最 终 
的 HTTP 回 复 ， 如 图 8-28 所 示 。 





HTTP 回复 







viwe.py 





context 


tA 


图 8-28 结果 返回 流程 
模板 系统 可 以 与 Django 的 其 他 功能 相互 合作 。 如 果 将 数据 库 中 的 数据 放 入 context 中 ， 那 么 就 可 以 将 数据 库 中 的 数据 传送 到 模板 。 


修改 app_test/views.py 中 的 templay: 





# -*- coding: utf-8 -*- 





#from django.http import HttpResponse 
from django.shortcuts import render 























def templay (request): 

fcontext- {} 

#context['label'] = 'Hello World!' 

templay list = Character.objects.all() 

templay str = map(str, templay list) 

context = ('label': ' '.join(templay str)] 

return render (request, 'app test/templay.html', context) 
































练习 : 显示 上 面 的 templay 页 面 ， 如 图 8-29 所 示 。 


10.20.0.50 





I» c 10.20.0.50:8080/app test/templa, | + 


zhangsl lisi2 wangwu3 


图 8-29 ”结果 返回 流程 


8.5.3 ”使 用 循环 
Django 提 供 了 丰富 的 模板 语言 ， 可 以 在 模板 内 部 有 限度 地 编程 ， 从 而 更 方便 地 编写 视图 和 传送 数据 。 下 面体 验 一 下 常见 的 循环 与 判断 。 
8.5.3 节 中 提 到 的 templay 中 的 数据 实际 上 是 一 个 数据 容器 ， 其 中 有 三 个 元 素 ， 传 送 时 将 三 个 元 素 连接 成 一 个 字符 串 进行 传送 。 实 际 上 利用 模板 语言 ， 可 以 直接 传送 数据 容器 本 身 ， 再 循环 显示 。 


修改 templay () : 








# -*- coding: utf-8 -*- 














#from django.http import HttpResponse 
from django.shortcuts import render 
from app test.models import Character 




















def templay (request) : 
templay list = Character.objects.all() 
return render (request, 'app test/templay.html', {'templay': templay list]) 




















从 数据 库 中 查询 到 的 三 个 对 象 都 在 templay _ list 中。 直接 将 templay list 传 送 给 模板 。 


将 模板 templay.html 修 改 为 





($ for item in templay %} 
<p>{{ item.id Jj, {{item}}</p> 
($ endfor %} 








以 类 似 于 Python 中 for 循 环 的 方式 来 定义 模板 中 的 for， 来 显示 templay 中 的 每 个 元 素 ， 如 图 8-30 所 示 。 另 外 ， 对 象 .属性 名 的 引用 方式 可 以 直接 用 于 模板 中 。 
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图 8-30 for 循环 的 显示 效果 


选择 结构 也 与 Python 类 似 。 根 据 传送 来 的 数据 是 否 为 True，Django 选 择 是 否 显示 。 使 用 方式 如 下 : 










































































($ if conditionl $2] 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... display 1 
($ elif condiiton2 $] 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... display 2 
($ else %} 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... display 3 
($ endif %} 





8.5.4 ”模板 继承 


模板 可 以 用 继承 的 方式 来 实现 复 用 。 下 面 用 templay.html 来 继承 base.html， 这 样 可 以 使 用 base.htm| 的 主体 只 替换 掉 特定 的 部 分 。 


新 建 templates/base.html: 


«html» 

«head» 
<title>templay</title> 
</head> 





<body> 
<hl>come from base.html</h1> 
($ block mainbody %} 
<p>original</p> 
% endblock %} 
</body> 
</html> 








该 页 面 中 ， 名 为 mainbody 的 block 标 签 是 可 以 被 继承 者 们 蔡 换 掉 的 部 分 。 在 下 面 的 templay.html 中 继承 base.html， 并 蔡 换 特定 block : 





© 


$ extends "base.html" £j 


($ block mainbody %} 





($ for item in templay %$} 
<p>{{ item.id }},{{ item.name }}</p> 
$ endfor %} 





$ endblock %} 


执行 结果 如 图 8-31 所 示 。 
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图 8-31 模板 继承 效果 


第 一 句 说 明 templay.html 继 承 自 base.html。 可 以 看 到 ， 这 里 相同 名 字 的 block 标 签 用 以 替换 base.html 的 相应 block。 


8.6 表单 


前 面 介绍 了 采用 手动 的 方式 ， 直 接 在 数据 库 插 入 数据 。 本 节 将 介绍 客户 向 服务 器 传递 数据 的 方式 。 其 中 表单 是 客户 向 服务 器 传 数据 的 经 典 方 式 。 


8.6.1 提交 表单 (GET 方法 ) 


HTTP 协 议 以 “请 求 -回复 ”的 方式 工作 。 客 户 发 送 请 求 时 ， 可 以 在 请 求 中 附加 数据 。 服 务 器 通过 解析 请 求 ， 可 以 获得 客户 传 来 的 数据 ， 并 根据 URL 来 提供 特定 的 服务 。 


HTML 文 件 中 可 以 包含 表格 标签 。HTML 表 格 的 目的 是 帮助 用 户 构 成 HTTP 请 求 ， 用 GET 或 者 POST 的 方法 把 数据 传递 给 某 一 URL 地 址 。 下 面 是 一 个 表格 的 例子 : 





«form action="/app test/investigate/" method="get"> 
<input type="text" name="templay"> 
<input type="submit" value="Submit"> 
</form> 




















这 里 的 <form> 标 签 有 两 个 属性 。action 用 于 说 明 URL 地 址 ，method 用 于 说 明 请 求 的 方法 。 


表单 中 还 包含 两 个 <input> 标 签 ， 即 两 个 输入 栏目 。 根 据 type 的 不 同 ， 第 一 个 <input> 标 签 为 一 个 文本 框 ， 第 二 个 <input> 标 签 为 一 个 提交 按钮 。name 为 输入 栏 的 名 字 。 服 务 器 在 解析 数据 时 ， 将 以 
name 为 索引 。 


可 以 将 上 面 的 表格 直接 存 入 模板 form.html， 并 在 app_test/views.py 中 定义 一 个 视图 form () 来 显示 表格 : 





from django.shortcuts import render 














def form(request): 
return render (request, 'app test/form.html') 











设置 urls.py， 让 对 [site]/app_test/form/ 的 访问 ， 指 向 该 视图 ; 然后 在 app_test/views.py 中 定义 investigate () 来 处 理 该 表格 提交 的 数据 : 








from django.shortcuts import render 








def investigate (request): 
rlt = request.GET['templay'] 
return HttpResponse (rlt) 




















可 以 看 到 HTTP 请 求 的 相关 信息 ， 包 括 请 求 的 方法 、 提 交 的 数据 ， 都 包含 在 request 参 数 中 。 表 单 是 通过 GET 方 法 提交 的 。 可 以 通过 request.GET[templay'] 来 获得 name 作 为 templay 的 输入 栏 的 数据 。 


该 数据 是 一 个 字符 串 。investigate () 将 直接 显示 该 字符 串 。 
设置 urls.py， 让 该 处 理 函 数 对 应 action 的 URL ([site]/app test/investigate/) 。 


当 我 们 访问 http://10.20.0.50:8080/app_ test/form 时 ， 显 示 效 果 如 图 8-32 所 示 。 
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图 8-32 ”提交 数据 


8.6.2 ”提交 表单 (POST 方法 ) 


在 8.6.1 节 我 们 使 用 了 GET 方 法 ， 将 视图 显示 和 请 求 处 理 分 成 两 个 国 数 处 理 。 提 交 数 据 时 更 常用 POST 方法 。 下 面 使 用 POST 方法 ， 并 用 一 个 URL 和 处 理 函 数 ， 同 时 显示 视图 和 处 理 请 求 。 
先 创建 模板 jinvestigate.htm|: 


«form action="/app test/investigate/" method="post"> 

$ csrf token %} 
<input type="text" name="templay"> 
<input type="submit" value-"Submit"» 


























<p>{{ rlt }}</p> 
修改 提交 表格 的 方法 为 “post”。 在 模板 的 未 尾 ， 我 们 增加 一 个 rlti 记 号 ， 为 表单 处 理 结果 预 留 位 置 。 
表单 后 面 还 有 一 个 {%csrf_token%} 的 标签 ， 这 是 Django 提 供 的 防止 伪装 提交 请 求 的 功能 。 采 用 POST 方 法 提交 的 表格 ,必须 有 此 标签 。 


在 app_test/views.py 中 ， 用 investigate () 来 处 理 表格 : 





from django.shortcuts import render 
from django.core.context processors import csrf 

















def investigate (request): 
ctx -(] 
ctx.update (csrf (request) ) 
if request.POST: 

ctx['rlt'] = request.POST['templay'] 
return render (request, "investigate.html", ctx) 

















这 里 的 csrf () 是 和 上 面 的 {%csrf_token%} 对 应 。 对 于 该 URL， 可 能 有 GET 或 者 POST 方 法 。if 的 语句 有 POST 方 法 时 ， 额 外 的 处 理 即 提取 表格 中 的 数据 到 环境 变量 。 页 面 执行 效果 如 图 8-33 所 示 。 
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图 8-33 ”提交 数据 


8.7 ”存储 数据 


前 面 提 交 的 数据 只 是 显示 在 页 面 上 了 ， 下 面 通过 模型 Character 将 数据 写 入 数据 库 。 
修改 app_test/views.py 的 investigate () : 


from django.http import HttpResponse 
from django.shortcuts import render 
from app test.models import Character 


from django.core.context processors import csrf 


























def investigate (request): 

if request.POST: 

submitted = request.POST['templay'] 

new record = Character (name = submitted) 
new_record. save () 

tx ={} 

tx.update (csrf (request) ) 

ll records = Character.objects.all() 























C 
e: 
a 
ctx['templay'] = all records 





return render (request, "app test/investigate.html", ctx) 








在 POST 的 处 理 部 分 ， 调 用 Character 类 创建 新 的 对 象 ， 并 让 该 对 象 的 属性 name 等 于 用 户 提交 的 字符 串 。 通 过 save () 方法 让 该 记录 入 库 。 


随后 ， 从 数据 库 中 读 出 所 有 对 象 ， 并 传递 给 模板 ; 还 需要 修改 模板 investigate.html， 以 更 好 地 显示 : 





«form action="/app test/investigate/" method="post"> 

$ csrf token $] 
<input type="text" name="templay"> 
<input type="submit" value-"Submit"» 
</form> 


























($ for person in templay 3%} 
<p>{{ person }}</p> 
$ endfor %} 














使 用 模板 语言 中 的 for 语 句 来 显示 所 有 的 记录 ， 效 果 如 图 8-34 所 示 。 
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图 8-34 提交 数据 到 数据 库 中 


8.8 表单 对 象 


客户 提交 数据 后 ， 服 务 器 往往 需要 对 数据 做 一 些 处 理 。 例 如 ， 检 验 数 据 ， 查 看 其 是 否 符合 预期 的 长 度 和 数据 类 型 。 在 必要 的 时 候 ， 还 需要 对 数据 进行 转换 ， 如 将 字符 串 转 换 成 整数 。 这 些 过 程 通常 都 相 
SA, 


Django 提 供 的 数据 对 象 可 以 大 大 简化 这 些 过 程 。 该 对 象 用 于 说 明 表 格 所 预期 的 数据 类 型 和 其 他 的 一 些 要 求 。 这 样 ，Django 在 获得 数据 后 ， 便 可 以 自动 根据 该 表格 对 象 的 要 求 对 数据 进行 处 理 。 
修改 app_test/views.py: 


from django.shortcuts import render 
from django.core.context processors import csrf 











from app test.models import Character 











from django import forms 





class CharacterForm(forms.Form): 
name = forms.CharField (max length = 200) 














def investigate (request) : 

if request.POST: 

form = CharacterForm (request. POST) 

if form.is valid(): 

submitted = form.cleaned data['name'] 
new record = Character (name = submitted) 
new_record. save () 
































form = CharacterForm() 

LX ={} 

tx.update (csrf (request) ) 

ll records = Character.objects.all () 
tx['templay'] = all records 

tx['form'] = form _ 

return render (request, "app test/investigate.html", ctx) 











aavaa 

















上 面 程序 定义 了 CharacterForm 类 ， 并 通过 属性 name， 说 明了 输入 栏 name 的 类 型 为 字符 串 ， 最 大 长 度 为 200。 
在 investigate 函 数 中 ， 根 据 POST 直 接 创立 form 对 象 。 该 对 象 可 以 直接 判断 输入 是 否 有 效 ， 并 对 输入 进行 预 处理 。 空 白 输 入 被 视 为 无 效 。 再 次 创建 一 个 空 的 form 对 象 ， 并 将 它 交 给 模板 显示 。 


在 模板 investigate.html 中 ， 可 以 直接 显示 form 对 象 : 





«form action="/app test/investigate/" method="post"> 
($ csrf token %} 

(( form.as p }} 
<input type="submit" value-"Submit"» 











</form> 








($ for person in templay %} 
<p>{{ person }}</p> 
($ endfor %} 








如 果 有 多 个 输入 栏 ， 可 以 用 相同 的 方式 直接 显示 整个 orm ， 而 不 是 加 入 许多 个 <input> 标 签 。 效 果 如 图 8-35 所 示 。 
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8.99 admin 


Django 提 供 一 个 管理 数据 库 的 APP， 即 django.contrib.admin。 这 是 Django 最 方便 的 功能 之 一 。 通 过 该 APP， 我 们 可 以 直接 经 由 Web 页 面 来 管理 数据 库 。 这 一 工具 主要 被 网 站 管理 人 员 使 用 。 


这 个 APP 通 常 已 经 预 装 好 ， 可 以 在 mysite/settings.py 中 的 INSTALLED APPS 看 到 它 。 


8.9.1 默认 管理 


admin 界 面 位 于 [site]/admin 这 个 URL。 这 通常 在 mysite/urls.py 中 已 经 设置 好 。 例 如 ， 下 面 是 本 次 示例 的 urls.py: 


from django.conf.urls import patterns, include, url 








from django.contrib import admin 
admin.autodiscover () 








urlpatterns - patterns('', 


url(r'^admin/', include (admin.site.urls)), 
url(r'^$', 'mysite.views.first page'), 
url(r'^app test/', include('app test.urls')), 




















为 了 让 admin 界 面 管 理 某 个 数据 模型 ， 我 们 需要 先 注册 该 数据 模型 到 admin。 例 如 ， 我 们 之 前 在 app_test 中 创建 的 模型 Character。 修 改 app_test/admin.py: 


from django.contrib import admin 
from app test.models import Character 











# Register your models here. 
admin.site.register (Character) 











访问 http://10.20.0.50:8080/admin， 登 录 后 可 以 看 到 管理 界面 ， 如 图 8-36 所 示 。 
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A8-36 ”登录 后 的 管理 页 面 


这 个 页 面 除了 app_test.characters 外 ， 还 有 用 户 和 组 信息 。 它 们 来 自 Django 预 装 的 Auth 模 块 。 我 们 将 在 以 后 处 理 用 户 管理 的 问题 。 


8.9.2 ”复杂 的 模型 


管理 页 面 的 功能 强大 ， 完 全 有 能 力 处 理 更 加 复杂 的 数据 模型 。 
先 在 app_test/models.py 中 增加 一 个 更 复杂 的 数据 模型 : 


这 里 有 两 个 表 ， 分 别 为 Tag 和 Contact。Tag 以 Contact 为 外 键 。 一 个 Contact 可 以 对 应 多 个 Tag。 


class Contact (models.Model): 
name = models.CharField (max length-200) 
age = models.IntegerField (default-0) 
email = models.EmailField() 
def unicode (self): 
return self.nam 
































class Tag (models.Model): 
contact = models.ForeignKey (Contact) 
name = models.CharField (max length-50) 
def unicode (self): 
return self.name 











在 这 个 程序 中 还 可 以 看 到 许多 之 前 没有 见 过 的 属性 类 型 ， 例 如 ，lntegerField 用 于 存储 整数 。 登 录 后 的 管理 页 面 如 图 8-37 所 示 。 


Contact 
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rage 


+email 





同步 数据 库 : 





Spython manage.py syncdb 
or 
Diango1.9 以 上 版 本 。 


Spython manage.py makemigrations 
Spython manage.py migrate 








命令 执行 结果 如 图 8-38 所 示 。 


[root&control mysite]£ python manage.py makemigrations 
System check identified some issues: 


WARNINGS: 
?7: (1 8.w001) The standalone TEMPLATE * settings were deprecated in Django 1.8 and the TEMPLATES dictionary takes precedence. You must 
put the values of the following settings into your default TEMPLATES dict: TEMPLATE DIRS. 


Migrations for 'app test'- 
0002 contact tag.py: 

- Create model Contact 
- Create model Tag 


图 8-38 ”命令 执行 结果 


在 app_test/admin.py 注 册 多 个 模型 并 显示 : 








from django.contrib import admin 


from app test.models import Character, Contact, Tag 











# Register your models here. 
admin.site.register([Character, Contact, Tag]) 





模型 将 在 管理 页 面 显示 。 例 如 ，Contact 添 加 条 目的 页 面 如 图 8-39 所 示 。 
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Home > App Test» Contacts » Add contact 


Add contact 


Name: 一 一 下 


图 8-39 页面 效 果 


8.9.3 ” 目 定 义 页 面 


可 以 自 定义 管理 页 面 来 取代 默认 的 页 面 如 8.9.2 节 提 到 的 add 页 面 。 我 们 想 只 显示 name 和 email 部 分 。 修 改 app_test/admin.py: 





from django.contrib import admin 
from app test.models import Character, Contact, Tag 














# Register your models here. 
class ContactAdmin (admin.ModelAdmin) : 
fields = ('name', 'email') 





admin.site.register(Contact, ContactAdmin) 
admin.site.register([Character, Tag]) 








上 面 定义 了 一 个 ContactAdmin 类 ， 用 以 说 明 管 理 页 面 的 显示 格式 。 其 中 ，fields 属 性 用 以 说 明 要 显示 的 输入 栏 ， 这 里 没有 让 “age” 显示 。 由 于 该 类 对 应 的 是 Contact 数 据 模 型 ， 我 们 在 注册 的 时 候 ， 
需要 将 它们 一 起 注册 。 管 理 页 面 显示 效果 如 图 8-40 所 示 。 


还 可 以 将 输入 栏 分 块 ， 使 每 一 块 输入 栏 以 自 定义 的 格式 显示 。 修 改 app_test/admin.py: 


from django.contrib import admin 
from app test.models import Character, Contact, Tag 











# Register your models here. 
class ContactAdmin (admin.ModelAdmin) : 
fieldsets = ( 
['Main', { 
'fields':('name','email'), 








Fly 
['Advance', { 

'classes': ('collapse',), 4 CSS 
'fields': ('age',), 





}] 
) 


admin.site.register(Contact, ContactAdmin) 
admin.site.register([Character, Tag]) 
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图 8-40 管理 页 面 的 显示 效果 


上 面 的 栏目 分 为 Main 和 Advance 两 部 分 。classes 说 明 它 所 在 部 分 的 CSS 样 式 格式 。 这 里 可 以 让 Advance 部 分 收敛 起 来 ， 页 面 效 果 如 图 8-41 所 示 。 若 要 展开 Advance 部 分 ， 可 单 击 Advance 旁 边 的 Show 
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Home » App [est » Contacts » Add contact 


Add contact 


Advance (show) 


图 8-41 管理 页 面 的 显示 效果 


89.4 Inline 显 示 


前 面 的 Contact 是 Tag 的 外 键 ， 所 以 两 者 有 外 部 参考 的 关系 。 而 在 默认 页 面 中 ， 两 者 是 分 离开 来 的 ， 无 法 体现 出 两 者 的 从 属 关系 。 我 们 可 以 使 用 Inline， 让 Tag 附 加 在 Contact 的 编辑 页 面 上 显示 。 


修改 app_test/admin.py: 





from django.contrib import admin 


from app test.models import Character, Contact, Tag 














# Register your models here. 
class TagInline (admin.TabularInline): 














model = Tag 
class ContactAdmin (admin.ModelAdmin) : 
inlines = [TagInline] # Inline 
fieldsets = ( 
['Main', { 
'fields':('name','email'), 
)], 
['Advance', { 
'classes': ('collapse',), 
'fields': ('age',), 





}] 
) 


admin.site.register(Contact, ContactAdmin) 
admin.site.register([Character]) 











显示 效果 如 图 8-42 所 示 。 





Home> App Test» Contacts > Add contact 





Add contact 





Email: 


Advance (Show) 





d Add another Tag 


8.9.5 ”列表 页 的 显示 


在 Contact 输 入 数 条 记录 后 ，Contact 的 列表 页 如 图 8-43 所 示 。 


Welcome, root. View site / Change password / Log out 





Home » App Test » Contacts 








Select contact to change 
Action: | 三 = v| Go| 0 of 1 selected 

| Name 

O zhangsi 
1 contact 


图 8-43 Contact 默认 显示 


也 可 以 自 定 义 该 页 面 的 显示 ， 例 如 ， 要 在 列表 中 显示 更 多 的 栏目 ， 只 需要 在 ContactAdmin 中 增加 list display 属性 : 





from django.contrib import admin 
from app test.models import Character, Contact, Tag 











# Register your models here. 
class ContactAdmin (admin.ModelAdmin) : 
list display = ('name','age', 'email') # list 





admin.site.register(Contact, ContactAdmin) 
admin.site.register([Character, Tag]) 





列表 页 新 的 显示 效果 如 图 8-44 所 示 。 


Tm um T un ry "ui [ma] | 
j 34 Mel ill OO N i! 





Home » App Test» Contacts 


Select contact to change 


Action | m— me T | Go 0 of 1 selected 


|| Name Age Email 
l| zhangsi 20 zhangsi@awcloud.com 
l contact 


图 8-44 Contact 修改 后 的 显示 


还 可 以 为 该 列表 页 增加 搜索 栏 ， 搜 索 功 能 在 管理 大 量 记 录 时 非常 有 用 。 这 里 使 用 search_fields 说 明 要 搜索 的 属性 : 





from django.contrib import admin 
from app test.models import Character,Contact, Tag 








# Register your models here. 

class ContactAdmin (admin.ModelAdmin): 
list display = ('name','age', 'email') 
search fields = ('name',) 














admin.site.register(Contact, ContactAdmin) 
admin.site.register([Character]) 








页 面 的 显示 效果 如 图 8-45 所 示 。 





Home> App Test » Contacts 


Select contact to change 


a 


Action: | -一 一 一 v |Go| 0 of 1 selected 


| Name Age Email 
(| zhanusi 20 zhanasi&gawcloud.com 
1 contact 


图 8-45 页面 的 显示 效果 


Django 的 管理 页 面 有 很 丰富 的 数据 库 管 理 功能 ， 并 可 以 自 定义 显示 方式 ， 是 非常 值得 使 用 和 修改 的 工具 。 


8.10 EXT 


1.File does not exist 


File does not exist 的 错误 示例 图 8-46 所 示 。 


10.20.0.50 








> | O TemplateDoesNotExist at /app te | 十 


TemplateDoesNotExist at /app test/templay 
templay. html 


Request Method: GET 
Request URL: http://10.20.0.50:8080/app test/templay 
Django Version: 1.8.10 
Exception Type: TemplateDoesNotExist 
Exception Value: templay, html 
Exception Location: /usr/lib/python?. T/site-packages/django/template/loader. py in get template, line 46 
Python Executable: /usr/bin/python 
Python Version: 2.1.5 
Python Path: [ /opt/mysite', 

" fopt/stack/kewvstaone, 
"fopt/stack/glance , 
"fopt/stack/cinder , 
"lopt/stack/nowa , 
"f opt stack horizon, 
'fopt/stack/neutron , 
' lusr/libB4/python?T. zip’, 
* 'usr/libB4/python?.T', 
' 'usr/libB4/python?Z. T/plat-limnux?', 
" Iusr/libB4/pythonz. T/lib-tk , 
" fusr/libO4/pythonz. T/lib-old , 
" Pusr/libO4/python?. T/lib-dynload , 
' 'usr/libB4/python?. T/site-packages , 
' Iusr/lib/prthonz. T/'site-packagesz | 


Server time: Wed, 12 Oct 2016 00:50:07 +0000 


Template-loader postmortem 


Django tried loading these templates, in this order: 

二 Using loader django. template. loaders, filesystem. Loader: 

« Using loader django. template. loaders. app directories. Loader: 
o /uzr/lib/python?. T/site-packagez/django/contrib/admin/templatez/templay.html (File does not exist! 
a /usr/lib/python?Z. T/site-packagez/d]ango/contrib/auth/templatez/templay.html (File does not exist! 
WE onti mysite app test/templates/templay. html (File does not exist) 





Ej8-46 RAS] LH 
解决 方法 : 
1) 把 模板 复制 到 图 8-46 阴 影 处 选择 的 路 径 中 。 
2) 增加 模板 文件 所 在 的 路 径 。 
2.global name ‘Character’ is not defined 


global name ‘Character’ is not defined 的 错误 如 图 8-47 所 示 。 


Traceback switch to copy-and-paste view 


fusr/ lib python. T/site-packazgez/djanzo/core/handlerz/base.py in get response 
132. response = wrapped callbackírequest, *callback args, **callback kwargz) 


+ Local vars 
fopt/mysite/app test/views. py in templay 
g. templay list = Character. objects, allí] 


® Local vars 


图 8-47 没有 导入 表 的 类 
解决 方法 : 


在 错误 提示 的 文件 添加 如 下 语句 (本 例 是 app_test/views.py 中 ) : 








from app test.models import Character 








3. 界 面 访问 不 了 


1) 程序 运行 出 错 导 致 ， 如 图 8-48 所 示 。 


Traceback (most recent call last): 
File "/usr/lib/python2.7 /site-packages/django/utils/autoreload.py", line 229, in wrapper 
fn(*args, **kwargs) 
File "/usr/lib/python2./ /site-packages /django/core/management /commands /runserver.py", line 107, in inner run 
autoreload.raise last exception() 
File "/usr/lib/python2./7/site-packages/django/utils/autoreload.py", line 252, in raise last exception 
six.reraise(* exception) 
File "/usr/lib/python2.//site-packages/django/utils/autoreload.py", line 229, in wrapper 
fn(*args, **kwargs) 
File "/usr/lib/python2.7/site-packages/django/ init .py", line 18, in setup 
apps.populate(settings.INSTALLED. APPS) 
File "/usr/lib/python2./7/site-packages/django/apps/registry.py", line 115, in populate 
app config.ready() 
File "/usr/lib/python2.7/site-packages/django/contrib/admin/apps.py", line 22, in ready 
self.module.autodiscover() 
File "/usr/lib/python2./7/site-packages/django/contrib/admin/ init .py", line 24, in autodiscover 
autodiscover modules('admin', register to-site) 
File "/usr/lib/python2.7/site-packages/django/uti ls/module loading.py", line 74, in autodiscover modules 
import_module('%s.%s' % (Capp config.name, module to search)) 
File "/usr/lib64/python2.7/importlib/ init .py", line 37, in import module 
. import (name) 
File "/opt/mysite/app test/admin.py", line 9, in «module» 
admin.site.register(Contact, ContactAdmin) 
NameError: name 'ContactAdmin' is not defined 
[2016-10-19 13:25:28,867 pyinotify ERROR] The pathname '/opt/mysite/app test/admin.py' of this watch «watch wd=528 path=/opt/mysite/app 
_test/admin.py mask-4038 proc fun-zNone auto add-False exclude filter-«function «lambda» at 0x2188140> dir-False > has probably changed 
and couldn't be updated, so it cannot be trusted anymore. To fix this error move directories/files only between watched parents directo 
ries, in this case e.g. put a watch on '/opt/mysite/app test'. 
Performing system checks... 


图 8-48 ”程序 出 错 
解决 方法 : 


查看 服务 的 启动 界面 是 否 有 提示 (本 例 是 提示 第 9 行 有 错误 ) ， 需 要 定位 一 下 该 错误 。 对 于 本 示例 ， 在 查看 后 发 现 是 大 小 写 导 致 ， 如 图 8-49 所 示 。 


# Register your models here. 

class cissuwstew: teils ( admin.ModelAdmin): 
list display = ('name', age' , ‘email’ ) 
search fields = ( name ,) 





admin.site.register(Contact, ContactAdmin) 
admin.site.register([character ]) 


图 8-49 ”大 小 写 导 致 错误 
Q 
Python 严格 区 分 大 小 写 ; 在 代码 修改 正确 后 ， 服 务 会 自动 重启 。 
2) 启动 服务 的 端口 被 防火 墙 阻 断 。 


需要 把 防火 墙 的 端口 放 开 ， 文 件 路 径 为 : /etc/sysconfig/iptables。 添 加 端口 ， 如 图 8-50 所 示 。 


:INPUT ACCEPT [0:0] 

:FORWARD ACCEPT [0:0] 

:OUTPUT ACCEPT [0:0] 

-A INPUT -m state --state RELATED,ESTABLISHED -j ACCEPT 

-A INPUT -p icmp -j ACCEPT 

-A INPUT -1 lo -j ACCEPT 

-A INPUT -p tcp -m state --state NEW -m tcp --dport 22 -j ACCEPT 

-A INPUT -p tcp -m state --state NEW -m tcp --dport 50 -j ACCEPT 

-A INPUT -p tcp -m state --5state iE. -m tcp -—dport 6080 -J ACCEPT 
INPUT : 1 state --state | 





-A INPUT 一 ] REJECT --reject-with icmp- host nono ted 
-A FORWARD -j REJECT --reject-with icmp-host-prohibited 
COMMIT 


图 8-50 ”防火 墙 添 加 8080 端 口 


oor 


修改 完 之 后 需要 重启 防火 墙 。 


8.11 ”本章 小 结 


本 章 主 要 对 Django 的 框架 等 内 容 进行 了 讲解 ， 并 通过 相应 代码 的 编写 实践 ， 为 后 面 学 习 Horizon 的 相关 内 容 葛 定 基础 ， 从 本 章 开始 要 练习 自己 编写 代码 并 解决 编程 中 出 现 的 错误 。 


第 9 章 Dashboard 的 开发 


Dashboard 是 OpenStack 中 提供 的 一 个 Web 前 端 控 制 台 ， 以 此 来 展示 OpenStack 的 功能 。 实 际 上 ，Dashboard 并 不 会 为 OpenStack 添 加 任何 新 的 功能 ， 它 只 是 使 用 了 OpenStack 部 分 API 功 能 。 


9.1 Dashboard 概 述 


Dashboard 需 要 和 几乎 所 有 的 OpenStack Service API 交 互 ， 而 且 各 个 服务 可 能 还 有 多 个 API 版 本 ， 需 要 针对 各 个 API 的 多 版 本 做 兼容 ; Dashboard 代 码 本 身 很 复杂 、 抽 象 ， 利 用 了 Django 相 当 多 的 高 
级 特性 ， 可 以 说 把 OOP 的 概念 运用 到 了 极致 ， 这 也 为 过 度 自 定制 Dashboard 带 来 了 麻烦 。 


Dashboard 是 基于 Django Web Framework 开 发 的 标准 的 Python WSGI 程 序 ，Django 的 设计 专注 于 代码 的 高 度 可 重用 ， 遵 循 DRY 原 则 ， 一 切面 向 对 象 ， 而 Dashboard 高 度 匹 配 了 Django 的 设计 风 


Dashboard 将 页 面 上 的 所 有 元 素 模 块 化 ， 网 页 中 一 些 常见 元 素 (如 表单 、 表 格 、 标 签 页 ) 全 部 被 封装 成 Python 类 ， 每 个 组 件 有 自己 对 应 的 一 小 块 HTML 模 板 。 当 泻 染 整个 页 面 的 时 候 ，Dashboard 先 查 
找 当 前 页 面 有 多 少 组 件 ， 然 后 将 各 个 组 件 分 别 进行 泻 染 变 成 一 段 HTML 片 段 ， 最 后 拼装 成 一 个 完整 的 HTML 页 面 ， 并 返回 给 浏览 器 。 


Dashboard 的 特点 可 简单 地 概括 为 以 下 两 点 : 
:页面 元 素 模块 化 。 


‘FORT GR. 


9.2 ”源码 解析 


首先 分 析 页 面 结构 ， 然 后 通过 PyCharm 导 入 Dashboard 源 码 ， 最 后 分 析 Dashboard 的 代码 结构 。 


9.2.1 Ul 整体 结构 


Dashboard 面 板 分 成 三 层 : Dashboard 一 PanelGroup 一 Panel，UlI 结 构 最 上 面 是 Header， 左 上 边 是 logo， 然 后 是 四 个 Dashboard， 每 个 Dashboard 下 面 有 若干 个 PanelGroup， 每 个 PanelGroup 有 
若干 个 Panel， 点 开 Panel 之 后 是 Panel Body，Panel Body 中 是 Data Table， 界 面 对 应 的 面板 结构 如 图 9-1 所 示 。 





>| S| 
E openstack 


Project | Dashboard | ~ 


Compute PanelGroup| -~ | # Project (3) | = t Shared with Me (0) | & Public (3) + Create Image 
- Image Name Type Status Public Protected Format Size Actions 
cirros-0.3.4-x86 64-uec | Data Table Image Active Yes No AMI 24.0 MB Launch | v 
Instances 
VEIRAN cirros-0.3.4-x86_64-uec-kernel Image Active Yes No AKI 4.7 MB Editlmage ~v 
| Images 口  cirros-0.3.4-x86 64-uec-ramdisk Image Active 3.6 MB Editlmage | v 


Access & Security 


Network v 
Admin v 
Identity Y 
Developer Y 


图 9-1 所 示 是 一 种 Data Table View, 


wA 


EED 


系统 


Images - OpenStack Dashboarc | + 


S admin + 


IMAGES panel Body 


Displaying 3 items 


图 9-1 


还 有 一 种 是 Tab View 样 式 ， 如 图 9-2 所 示 。 


| 








OpenStack 页 面 组 成 


` AJN A 信息 i 


, i 


rr E RES; 


Ls AR S 


C D 


& admin * 





Pops (ETE T 


图 9-2 Tab View 样式 
在 一 个 页 面 中 ， 每 个 Tab View 显 示 不 同 的 内 容 。 


每 一 个 Dashboard 都 是 Diango 中 的 一 个 APP，Dijango 中 的 APP 可 以 理解 成 对 业务 逻辑 模块 化 的 一 种 手段 ， 里 面 可 以 包含 自己 独 有 的 URL 设 定 、 模 板 和 业务 逻辑 代码 。 


92.2 1JliRDashboard 


使 用 的 工具 是 在 Windows 下 运行 的 pyCharm， 需 要 把 Dashboard (Mitaka 版 ) 的 代码 下 载 到 本 地 ， 然 后 导入 到 PyCharm 中 ， 如 图 9-3 所 示 。 








| 
horizon 


F- 








LO- 


mysite 


horizon 


test 


horizon 


Lrlgxrm d rr Ho i 全 


lE PyCharm Community Edition 


(o Welcome to 


PyCharm Community Edition 


-— TEC 


develop or 


F:\develop horizon 


\PreharePro ject 


HelloD;jango 


nlilimnmn - 


E" Create New Project 


F: develop horizon (horizon 


E- E Pr 
E- 回 i4Tools6 
由 (5 JMatch Amp 
EI FP kilo-test 
EF [1 epenstack 


cinder-mitaka. tar. gz 
-De cinder. tar. gz 














PyCharm Comunity Edition 4.0.6 Build 133 1653, Check for updates now. 


图 9-3 $ A Dashboard 4X, £l 


导入 后 的 Dashboard 代 码 如 图 9-4 所 示 。 其 中 manage.py 是 Django 工 程 的 管理 工具 。Django 的 setting 文 件 在 openstack _ dashboard 中 ， 如 图 9-5 所 示 。 


双击 打开 settings.py 文 件 ， 找 到 APP 的 地 方 : 











NSTALLE 








D APPS = 


[ 


'openstack ， dashboard’, 


ango. coni 
ango. conli 


ango.con 


TALLAR A 
Rt Loe eh We i 





ango. coni 


ango.cont 
ango.cont 
ango pyscss', 











Lribi contenttypes!, 
trib.auth' 
a r 
trib.messages', 
trib.staticfiles', 
trib.humanize', 





'openstack dashboard.django pyscss fix', 
'compressor', 


'horizon', 


'openstack auth', 











E- F3 horizon 


M . blackhole 

ET doc 

[^1 horizon 

[^1 horizon. egg-info 
[1 openstack dashboard 
M] releasenotes 


H- E static 
H- [7] tools 


- i .eslintignore 

| p^ [i .eslintre 

| m . g1 tıgnore 

| y . El tr ew ew 

| pen E .mailmap 

| pa [i .pylintrc 

| ! [i . testr. cont 

| y^ babel-django.ctg 
| pi [si babel-django]s. ctg 
— Bet CONTRIBUTING. rst 
— Bt HACKING. rst 








— [s] Makefile 

oo [E] MANIFEST. in 

| ien ison package. json 

— iSt README. rst 

| an requirements. txt 
| ien | run tests. sh 

| iie E setup. cg 

d A, setup. py 


3 = i= test-requirements. txt 


图 9-4 AL fj Dashboard, 4 


EF M horizon 
| 7m PJ blackhole 
H-E dac 
gr horizon 
H-E horizon. egg into 
E [7] openstack dashboard 
| [B [1 api 
- Po cont 
- F3 contrib 
- F1 dashboards 
- P| django pvscss fix 
$ enabled 
$ local 
- E] locale 
机 = management 
-EJ static 
- E] templates 
- E templatetags 
i = Lest 
- E themes 
- E] usage 
-Jutila 
- Ey wsgi 
m B , aslintrc 


o Amrt Ty 
context processors. py 


exceptions. py 





ont | 


"711 


|| 
I m m 





对 比 之 前 版 本 的 settings.py 文 件 ， 














NSTALLED APPS = ( 


'openstack dashboard', 


'django. 
'django. 
'django. 
'django. 
'django. 
'django. 


coni 
coni 
coni 
coni 


trib.contenttypes', 
trib.auth', 
trib.sessions', 
trib.messages', 








con 
coni 





trib.staticfiles', 
trib.humanize', 


'compressor', 
'horizon', 
'openstack dashboard.dashboards.admin', 

'openstack dashboard.dashboards.admin.remote management', 
'openstack dashboard.dashboards.project', 

'openstack dashboard.dashboards.project.financial manage.payment', 
'openstack dashboard.dashboards.project.tickets', 

'openstack dashboard.dashboards.admin.news', 

'openstack dashboard.dashboards.admin.awsettings', 

'openstack dashboard.dashboards.set 
'openstack dashboard.dashboards.project.awcustoms', 
'openstack auth', 

'openstack dashboard.dashboards.rou! 
'openstack dashboard.license' 








ph static settings. py 
S. theme settings. py 


B. urls. py 


vlews.pvy 


图 9-5 setting X4 


找到 APP 的 地 方 : 





tings"; 





ter', 


在 Mitaka 版 本 中 ，admin、project 等 应 用 被 放 在 openstack_dashboard 的 APP 中 ， 而 不 是 被 单独 当 作 一 个 APP 来 处 理 。 所 以 新 版 本 的 修改 会 有 些 变量 。 


9.2.3 MEA 


Dashboard 的 源码 中 主要 包含 两 个 代码 文件 夹 : horizon、openstack dashboard, 


1.horizon 


horizon 这 个 包 中 是 一 些 在 Django 基 础 上 编写 的 通用 组 件 ， 包 括 表 格 (table) 、 标 签 页 (tab) 、 表 单 (form) 、 导 航 (browser) 、 工 作 流 (workflow) ， 如 图 9-6 所 示 。 


È} horizon 
PF blackhole 


doc 





[E 
[E] 
Ea 
由 


[+h 


TE- 


5 


- D browsers 


-E conf 
-E contrib 
T forms 


-P hacking 


-P locale 


i = management 


-PJ static 
- D tables 


- D tabs 

- F templates 

- E templatetags 
" m test 

-P utils 


I= worktlows 


@ base. py 


m context processors. py 





2. decorators. py 


4. exceptions. py 


3€ karma. conf. is 


loaders. py 


messages. pF 





middleware. py 


notifications. py 


site urls. pr 


themes. py 


A version. py 


p views. DY 





A\9-6 horizon x 4F È 49 Z8 yx, 


这 些 代码 和 OpenStack 的 具体 业务 逻辑 没有 什么 关系 ， 如 果 要 做 一 个 新 的 Django 项 目 ， 理 论 上 可 以 复 用 horizon 这 个 包 中 的 代码 。horizon/base.py 中 还 实现 了 一 套 Dashboard/Panel 机 制 ， 使 得 
Horizon 面 板 上 所 有 的 Dashboard 都 是 “可 播 拔 ”的 ， 所 有 的 Panel 都 是 “动态 加 载 ” 的 。 


2.openstack dashboard 


openstack_ dashboard/dashboards/ 中 是 各 个 面板 的 具体 实现 代码 ， 其 中 包括 各 个 面板 的 模板 文件 和 后 端 Service 交 互 的 业务 逻辑 代码 等 ， 如 图 9-7 所 示 。 


openstack dashboard 


+- [1 api 
+- [1] conf 
t- LJ 


contrib 








admin 


E identity 
project 








settings 








init .py 


图 9-7 业务 逻辑 代码 


Horizon 现 在 可 以 在 保留 默认 设置 的 情况 下 增加 Dashboard、Panels 和 Panel Groups。 插 拔 式 配置 文件 被 存储 在 独立 的 文件 中 。enabled 目 录 如 图 9-8 所 示 ， 用 于 告诉 Horizon 在 泻 染 Dashboard 时 载 
入 这 些 Panel。enable 目 录 下 的 Dashboard 和 Pane| 是 按照 Python 文件 名 的 字典 序 添 加 的 ， 所 以 可 以 通过 _ 1000_*.py_2000_*.py 的 命名 来 控制 文件 名 的 字典 序 。 在 这 里 可 找到 页 面 上 对 应 的 project、admin 
等 对 应 的 调用 ， 双 击 打 开 _1000_project.py， 具 体 如 下 : 


E [7] enabled 





! teens BE JU admin add panel. py. example 

i oz [=] Ü admin remove panel. py. example 

! m B iU admin default panel. py. example 

: e [=] SU admin add panel group. py. example 

| = B 90 admin add panel to group. py. example 
1000 project py 

3 oz F  lü0llU compute panel group. py 

| a wh 1020 project overview panel. py 

| mm wh 1030 project instances panel.py 

! got wh 1040 project volumes panel.py 

| = a 1050 project images panel. py 

! e ph 1051 project ng images panel. py 

| e wh 1060 project access panel.py 

i e wh 1410 network panel group.py 

| m a _1420 project network topology panel. py 

! e wh 14350 project network panel. py 

! e wh 1440 project routers panel. py 

! x yh 1450 project loadbalancers panel. py 

! te m 1460 project firewalls panel. py 

i e wh 1243/0 project vpn panel.py 

! e wh 18610 orchestration panel group. py 

| m wh 1620 project stacks panel. py 

| e wh 18530 project resource types panel.py 

| e wh 19810 object store panel group. py 

| e m 1820 project containers panel. py 

m 2000 admin. py 

| Ee e 2010 admin system panel eroup. py 

: e 4. 2020 admin overview panel. py 


图 9-8 APP 调 用 关系 


DASHBOARD = = 'project' 

# If set to True, this dashboard will be set as the default dashboard. 
DEFAULT = True 
4 A dictionary of exception classes to be added to HORIZON['exceptions']. 
ADD EXCEPTIONS = {} 

# A list of applications to be added to INSTALLED APPS. 

ADD INSTALLED APPS = [‘openstack_dashboard.dashboards.project’ ] 




































































ADD ANGULAR MODULES = [ 
'horizon.dashboard.project', 





] 


AUTO DISCOVER STATIC FILES = True 









































ADD JS FILES - [] 








ADD JS SPEC FILES - [] 














DASHBOARD: 实际 上 是 想 要 添加 Dashboard 的 slug， 相 当 于 表示 了 这 个 Dashboard， 但 是 它 并 不 是 Dashboard 在 浏览 器 中 显示 的 名 字 ，required 必 须 填 。 

ADD INSTALLED APPS: 指定 这 个 Dashboard 下 的 application 的 目录 列表 。 因 为 在 Horizon 看 来 ， 一 个 Panel 和 一 个 APP 是 对 应 的 ， 而 Dashboard 下 是 一 组 Panel 的 集合 
ADD ANGULAR MODULES: Angular 启 动 的 时 候 载 入 AngularJS 模 块 。 

AUTO DISCOVER STATIC FILES: 设置 为 True，ADD INSTALLED APPSs 列 出 的 appSs 会 自动 加 载 static 目 录 下 的 js 文件 和 angular 静 态 HTML 模 板 文件 。 


根据 APPs 找 到 对 应 的 目录 ， 如 图 9-9 所 示 。 在 这 里 可 看 到 根 页 面 显示 的 内 容 基本 一 致 了 ， 其 他 admin、identity 目 录 可 以 自行 查看 。 





openstack_ dashboard 





A] contrib 
= dashboards 
g- F3 admin 
由 - J identi ity 





m 








P. uper iud sicui 


M containers 

M firewalls 

M] images 

M instances 

M loadbalancers 
M network topology 
[1 networks 


| = ngimages 
Pl overview 


Mum 







Ith | | routers 
此 | [1 stacks 


EH- [1 static 
ith M volumes 
[+ 











图 9-9 project 的 业务 逻辑 
3. 目 录 全 面 介绍 
下 面 对 Horizon 目 录 内 容 做 一 个 全 面 的 介绍 。 
(1) Horizon (通用 组 件 ) 
./doc: Horizon 相 关 帮 助 性 文档 。 
/horizon: Horizon 通 用 组 件 库 ， 如 表 9-1 所 示 。 
表 9-1 Hotrizon 通 用 组 件 库 
组 件 库 说 明 
/conf Horizon 配置 文件 tab KE 
/forms form 表单 基 类 包 PROCITE 
Nocale 国际 化 语言 包 模板 标签 基 类 
/management manage.py startdash/startpanel 命令 测试 包 
static Horizon if CFL L.H.fu 
/tables table 基 类 包 Lf E iC PL tl E 


(2) openstack dashboard (Horizon 各 个 面板 的 具体 实现 代码 ) 








./api: 调用 nova、swift、glance 等 接口 封装 。 
./conf: nova、cinder 等 API 访 问 权 限 控制 。 
./dashboards: Horizon 界 面 展示 各 个 模块 实现 目录 。 
/admin: FERAH. 

Vinstances: 云 主 机 管理 界面 ， 如 表 9-2 所 示 。 


A92 云 主 机 管理 界面 的 文件 组 成 


T T "m 


templates 云 主 机 HTML 界面 模板 测试 


./forms.py form 表单 实现 URL 映射 
/panel.py 实现 Panel 注册 到 Dashbord URL 映射 的 视图 
/tables.py table 实现 a 


/identity: 项 目 、 用 户 管理 界面 。 








Jproject: 普通 用 户 项 目 界 面 。 

/settings: 设置 界面 。 

/django pyscss fix: 

Jenabled: 控制 导航 加 载 哪些 模块 显示 出 来 。 
/local: 本 地 配置 文件 。 

/locale: 本 地 国家 化 语言 包 。 
./management: 定义 安装 Apache、Horizon 等 配置 文件 的 模板 文件 。 
./openstack: log、_i18n 等 包 .。 

./static: Horizon 静 态 包 。 

./templates: Horizon 模 板 包 。 
./templatetags: Horizon 模 板 标 签 包 。 
Jtest: 测试 包 。 

/usage: Horizon 概 况 页 面 资源 统计 实现 包 。 
/utils: TEB. 

./wsgi: WSGI 包 。 

tool: Horizon 工 具 包 。 

manage.py: Django 的 管理 工具 。 
requirements.txt: 依赖 包 。 

run tests.sh: 测试 脚本 。 
test-requirements.txt: 测试 依赖 包 。 
tox.ini: tox 测 试 的 配置 。 


在 openstack dashboard\dashboards\adminNinstances 目 录 发 现 的 内 容 同 第 8 章 Django 痕 迹 ， 有 urls.py、views.py、templates 的 内 容 。 


9.3 目 定 义 Dashboard 和 Panel 


使 用 Horizon 中 多 样 的 组 件 (主要 是 tables 和 tabs) 来 建立 一 个 Dashboard 和 Panel， 包 括 和 后 端的 数据 交互 。 本 节 将 创建 一 个 有 一 个 实例 标签 的 Panel， 这 个 标签 有 一 个 能 和 Nova 的 API 进 行 数据 交换 
的 table。 


9.3.1 手工 启动 Dashboard 工 程 


Dashboard 是 Django 架 构 开发 的 ， 因 此 可 以 通过 启动 Django 项 目的 方式 启动 Dashboard。 为 了 调试 Dashboard， 需 要 像 启动 Django 框 架 那 样 启 动 Dashboard， 进 入 DevStack 的 httpd 配 置 文件 目 





/etc/httpd/conf.d 


会 看 到 有 horizon、keystone 两 个 配置 文件 ， 如 图 9-10 所 示 。 
[rootücontrol conf.d]£ pwd 


/etc/httpd/conf. d 


[rootücontrol conf.d]# ls 
autoindex.conf  horizon.conf  keystone.conf README ssl.conf userdir.conf welcome. conf 


图 9-10 httbd 的 配置 目录 的 内 容 
Q 
httpd 启 动 了 horizon 和 keystone 两 个 服务 ， 如 果 把 httpd 停 挤 ， 这 两 个 服务 都 会 停 掉 ， 还 需要 手工 启动 keystone 服 务 。 
keystone 手 工 启动 命令 如 下 : 
/usr/bin/keystone-all 
horizon 手 工 启动 命令 如 下 : 


python manage.py runserver 10.20.0.50:8080 


at 


./run tests.sh --runserver 0.0.0.0:8080 





9.3.2 创建 Dashboard 


使 用 官方 提供 的 run_test.sh 脚 本 来 协助 创建 相关 文件 ， 切 换 到 stack 用 户 ， 然 后 进入 horizon 目 录 ， 命令 如 下 : 





Su - stack 
cd horizon/ 


1) 创建 mydashboard: 


mkdir openstack dashboard/dashboards/mydashboard 





2) 生成 文件 : 


./run tests.sh -m startdash mydashboard \ 
--target openstack dashboard/dashboards/mydashboard 





命令 执行 可 能 会 有 如 图 9-11 所 示 的 提示 ， 这 里 要 选择 “y”。 


[stackücontrol horizon]$ ./run tests.sh -m startdash mydashboard \ 
> --target openstack dashboard/dashboards/mydashboard 
Checking environment. 

Environment not found. Install? (Y/n) 


中 间 可 能 会 安装 相关 的 软件 包 ， 如 图 9-12 所 示 。 


Creating venv... done. 
Installing dependencies with pip (this can take a while)... 
Requirement already up-to-date: pip»-1.4 in ./.venv/lib/python2.7/site-packages 
Requirement already up-to-date: setuptools in ./.venv/lib/python2.//site-packages 
Collecting pbr 
Using cached pbr-1.10.0-py2.py3-none-any. whl 
Installing collected packages: pbr 
Successfully installed pbr-1.10.0 
Requirement already up-to-date: pbr»-1.6 in ./.venv/lib/python2.7/site-packages (from -r /opt/stack/horizon/requirements.txt (line 10)) 
Collecting Babel!-2.3.0,!-2.3.1,!-2.3.2,!-2.3.3,»-1.3 (from -r /opt/stack/horizon/requirements.txt (line 12)) 
Using cached Babel-2.3.4-py2.py3-none-any. wh] 
Collecting Django<1.9,>=1.8 (from -r /opt/stack/horizon/requirements.txt (line 13)) 
Downloading Django-1.8.15-py2.py3-none-any.whl (6.2MB) 
100% | | 6.2MB 31kB/s 
Collecting Pint>=0.5 (from -r /opt/stack/horizon/requirements.txt (line 14)) 
Downloading Pint-0.7.2.tar.gz (149kB) 
100% | | 153kB 105kB/s 
Collecting django-babel»-0.4.0 (from -r /opt/stack/horizon/requirements.txt (line 15)) 
Downloading django-babel-0.5.1.tar.gz 








oor 


安装 过 程 需 要 联网 ， 所 以 要 保证 DevStack 运 行 正常 。 
安装 完成 后 的 提示 信息 如 图 9-13 所 示 。 
OpenStack development environment setup is complete. 


OpenStack development uses virtualenv to track and manage Python 
dependencies while in development and testing. 


To activate the OpenStack virtualenv for the extent of your current shell 
session you can run: 


$ source /opt/stack/horizon/.venv/bin/activate 


Or, if you prefer, you can run commands in the virtualenv on a case by case 
basis by running: 


$ /opt/stack/horizon/tools/with venv.sh «your command- 
Also, make test will automatically use the virtualenv. 


图 9-13 ”安装 完成 


9.3.3 ”创建 mypanel 


1) 创建 目录 : 





mkdir openstack dashboard/dashboards/mydashboard/mypanel 





2) 生成 文件 。 执 行 如 下 的 命令 创建 相关 文件 : 
./run tests.sh -m startpanel mypanel \ 
s ard-open nstack dashboa aan rds.mydashboard \ 
arget-openstack dashboard/dashboards Wi shboard/mypanel 








命令 执行 完成 之 后 如 图 9-14 所 示 。 
[stack@control fer ene) ./run tests.sh -m startpanel mypane --dashboard-openstack dashboard.dashboards.mydashboard 
--target- openstack este dae Hee dc PE RON UMP 


Checking environment. 
Environment is up to date. 
图 9-14 命令 及 提示 


Q; BH 
条 命令 。 


上 面 多 行 是 一 条 命令 


自动 生成 的 目录 结构 如 图 9-15 所 示 。 


[rootücontrol dashboards |# tree mydashboard 


mydashboard 
dashboard. py 
dashboard. pyc 
_ amt. .py 
— amt .pyc 
mypane | 
_ amt. .py 
panel.py 
templates 
mypane | 
L— index.html 
tests.py 
uris.py 
v1ews.py 
static 
L— mydashboard 


5 
C. mydashboard. 1s 


SCSS 
L— mydashboard.scss 


temp lates 
mydashboard 
base.html 


13 files 


9 directories, 
图 9-15 “自动 生成 的 目录 结构 
93.4 ”编写 代码 


1. 定 义 Dashboard 
打开 dashboard.py 文 件 ,会 看 到 代码 已 经 被 自动 生成 了 ， 该 文件 内 容 如 下 : 





from django.utils.translation import ugettext lazy as - 








import horizon 


class Mydashboard (horizon.Dashboard) : 


name =  ("Mydashboard") 

slug = "mydashboard" 

panels = () # Add your panels here. 

default panel = '' # Specify the slug of the dashboard's default panel. 




















horizon. register (Mydashboard) 





Dashboard 类 通常 会 包括 name (Dashboard 对 外 所 呈现 的 名 称 ) . slug (被 其 他 组 件 引 用 的 内 部 名 称 ) 、Panel 列 表 和 默认 的 Panel 等 。 后 面 章 节 会 讲 到 如 何 增加 一 个 Panel。 
2. 定 义 mypanel 
本 节 将 创建 一 个 Panel 并 将 它 命名 为 mypanel。 


mypanel 的 文件 夹 在 openstack_dashboard/dashboards/mydashboard 下 ， 它 的 目录 结构 如 图 9-16 所 示 。 


mypanel | 

— Init. DY 

panel.py 

templates 

L— mypane | 
L— index. 





图 9-16 mypanel 自 动 生 成 的 目录 结构 
这 里 ，panel.py 文 件 有 一 个 特殊 的 意义 : 在 一 个 Dashboard 中 ，Dashboard 类 中 指定 的 “panels 属 性 ” 列 出 任何 模块 名 字 ， 将 自动 在 panel.py 文 件 中 查找 相应 的 记录 。 


打开 panel.py 文 件 ， 会 看 到 代码 已 经 自动 生成 了 ， 该 文件 内 容 如 下 : 


from django.utils.translation import ugettext lazy as - 








import horizon 


from openstack dashboard.dashboards.mydashboard import dashboard 





class Mypanel (horizon.Panel): 
name =  ("Mypanel") 


slug = "mypanel" 


dashboard.Mydashboard. register (Mypanel) 


oor 


一 旦 定义 了 它 ， 我 们 还 需要 在 Dashboard 中 注册 它 ， 通 常 在 panel.py 文 件 末 尾 ， 可 以 修改 panel.py 文 件 中 的 name 参 数 。 


再 次 编辑 dashboard.py 文 件 ， 修 改 Mygroup 和 Panel 的 定义 ， 完 成 后 的 内 容 如 下 : 





class Mygroup (horizon.PanelGroup): 
slug = "mygroup" 
name = ("My Group") 
panels = ('mypanel',) 


这 段 代 码 定义 了 Mygroup 类 并 且 增 加 了 一 个 名 为 mypanel 的 Panel。 


最 终 的 dashboard.py 文 件 内 容 如 下 : 


from django.utils.translation import ugettext lazy as - 








import horizon 


class Mygroup (horizon.PanelGroup): 
slug = "mygroup" 
name = ("My Group") 
panels = (‘mypanel’,) 


class Mydashboard (horizon.Dashboard) : 
name = ("My Dashboard") 





slug = "mydashboard" 
panels = (Mygroup,) # Add your panels here. 
default panel = ‘mypanel’ # Specify the slug of the default panel. 











horizon. register (Mydashboard) 





修改 Mydashboard 类 使 其 包含 Mygroup， 并 设置 mypane 为 默认 的 Panel。 
oh 


加 粗 部 分 为 新 增 内 容 ， 下 同 。 

3. 添 加 tables、tabs 和 views 

从 table 开 始 ， 把 table 和 tab 整 合 到 一 起 ， 最 后 把 它们 统一 合成 到 一 个 视图 (view) 中 。 
(1) 定义 tables 

Horizon 提 供 了 一 个 SelfHandlingForm DataTable 类 ， 简 化 了 绝 大 多 数 显示 数据 的 工作 。 


1) 新 建 tables.py 文 件 。 进 入 mypanel 目 录 ， 新 建 tables.py 文 件 内 容 如 下 : 





from django.utils.translation import ugettext lazy as - 














from horizon import tables 








class InstancesTable (tables.DataTable): 

















name — tables.Column("name", verbose name- ("Name")) 

status — tables.Column("status", verbose name- ("Status")) 

zone = tables.Column('availability zone', 
verbose name- ("Availability Zone")) 

image name = tables.Column('image name', verbose name- ("Image Name") ) 








class Meta: 
name — "instances" 
verbose name = ("Instances") 








上 面 的 程序 ， 创 建 了 一 个 table 子 类 ， 定 义 了 四 列 ， 每 列 定义 了 它 访问 实例 类 的 属性 作为 第 一 个 参数 ， 因 为 希望 所 有 的 事情 都 是 可 以 被 翻译 的 ， 我 们 给 每 列 赋予 一 个 verbose_name 以 标记 它们 可 以 被 翻 
iE; 最 后 添加 了 一 个 Meta 类 来 定义 一 些 描述 table 的 元 数据 。 


2) 添加 action 


Horizen 提 供 了 三 种 基本 的 action: Action、LinkAction、FilterAction。 另 外 ，Horizen 还 提供 了 四 种 扩展 的 action: BatchAction、DeleteAction、UpdateAction、FixedFilterAction。 这 些 都 在 
actions.py 文 件 中 定义 ， 如 图 9-17 所 示 。 


=H J tables 
init -py 












| P WE formset. py 
| Tart i | v1 eS D 


图 9-17  tables&7action Æ 3L 
例如 ， 要 创建 并 向 table 添 加 一 个 “filter action" ， 我 们 需要 编辑 table.py 文 件 。 添 加 了 “filter action” 后 ,我 们 将 只 能 看 到 jfilter 域 中 规定 的 字段 。 下 面 先 定义 一 个 FilterAction 类 : 


class MyFilterAction (tables.FilterAction) : 
name = "myfilter" 











然后 ， 将 这 个 action 加 入 到 table 中 : 





class InstancesTable: 


class Meta: 
table actions = (MyFilterAction, ) 


完整 的 table.py 如 下 : 





from django.utils.translation import ugettext lazy as - 











from horizon import tables 








class MyFilterAction (tables.FilterAction) : 
name = "myfilter" 











class InstancesTable (tables.DataTable) : 



































name = tables.Column('name', verbose name= ("Name") ) 

status = tables.Column('status', verbose name= ("Status") ) 

zone = tables.Column('availability zone', verbose name= ("Availability Zone") ) 
image name = tables.Column('image name', verbose name= ("Image Name") ) 














class Meta: 
name = "instances" 
verbose name = ("Instances") 


table actions = (MyFilterAction, ) 








(2) 定义 tabs 
有 了 table 就 可 以 接收 数据 ， 并 可 以 直接 得 到 一 个 视图 ， 这 种 情况 同样 适用 Horizon 的 TabGroup 类 ， 因 为 它 提供 了 一 个 和 干净、 简化 的 tabs 接 口 来 显示 可 视 化 数据 . 


在 mypanel 目 录 下 新 建 tabs.py 文 件 ， 内 容 如 下 : 





from django.utils.translation import ugettext lazy as - 





exceptions 
tabs 


from horizon impor! 
from horizon impor! 














from openstack dashboard import api 
from openstack dashboard.dashboards.mydashboard.mypanel import tables 














class InstanceTab (tabs.TableTab) : 























name = ("Instances Tab") 

slug = "instances tab" 

table classes = (tables.InstancesTable,) 

template name = ("horizon/common/ detail table.html") 
preload = Fals 








def has more data(self, table): 
return self. has more 

















def get instances data (self): 

try: 
marker = self.request.GET.get ( 

tables.InstancesTable. meta.pagination param, None) 
































instances, self. has more = api.nova.server list ( 
self.request, 
search opts={'marker': marker, 'paginate': True}) 








return instances 
except Exception: 
self. has more - False 
error message =  ('Unable to get instances!) 
exceptions.handle(self.request, error message) 














return [] 


class MypanelTabs (tabs.TabGroup): 
slug = "mypanel tabs" 
tabs = (InstanceTab,) 
sticky = True 





这 个 tab 有 一 点 复杂 。tab 处 理 tables 的 数据 以 及 所 有 有 关 的 特性 ， 同 时 它 可 以 使 用 preload 属 性 来 指定 这 个 tab 是 否 被 加 载 ， 默 认 情况 下 为 不 加 载 。 当 单 击 它 时 ， 它 将 通过 AJAX 方 式 加载 ， 在 绝 大 多 数 情 
况 下 保存 我 们 的 API 调 用 。 此 外 ，table 的 展示 是 由 一 个 可 重复 使 用 的 模板 控制 的 ， 一 些 翻 页 代码 (horizon/common/ detail table.html) 也 被 增加 进去 了 ， 用 来 处 理 大 量 的 实例 列表 。 


Ba, XESS 





进 了 错误 处 理 机 制 的 horizon.exceptions.handle () 函数 。 
(3) 整合 views 
horizon 中 有 很 多 基于 类 的 预 建 视图 ， 试 着 给 所 有 通用 整合 组 件 提供 起 始点 。 


修改 views.py 的 内 容 : 


from horizon import tabs 








from openstack dashboard.dashboards.mydashboard.mypanel \ 
import tabs as mydashboard tabs 


class IndexView (tabs.TabbedTableView): 
tab group class = mydashboard tabs.MypanelTabs 
template name = 'mydashboard/mypanel/index.html ' 























def get data(self, request, context, *args, **kwargs): 
# Add data to the context herehttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
return context 
































在 Django 框 架 中 ， 视 图 就 是 一 个 Python 函数 ， 它 接收 httpRequest 的 参数 ， 返 回 httpResponse 对 象 。Django 得 到 这 个 返回 对 象 后 ， 将 它 转换 成 对 应 的 HTTP 响 应 ， 显 示 网 页 内 容 。 
(4) 修改 urls 


修改 url.py 的 内 容 : 


from django.conf.urls import 
from django.conf.urls import 


patterns 
url 




















from openstack dashboard.dashboards.mydashboard.mypanel import views 





urlpatterns = patterns('', 
uel (EVs, 
views .IndexView.as view(), name-'index'), 





urlpatterns 第 一 个 参数 是 用 字符 串 显示 地 表示 该 页 面 所 用 的 通用 视图 函数 前 缀 ， 指 出 当前 要 用 到 的 视图 函数 都 在 那个 模块 文件 ， 上 例 为 空 ， 代 码 中 的 示例 文件 如 下 : 


/openstack dashboard/dashboards/project/overview/views.py 
urlpatterns = patterns ( 
'openstack dashboard.dashboards.project.overview.views', 
url(r'^$', views.ProjectOverview.as view(), name-'index'), 
url(r'^warning$', views.WarningView.as view(), name-'warning'), 





url () 参数 定义 了 要 显示 的 URL 网 页 目录 和 对 应 视图 函数 的 映射 ， 这 也 称 为 URLpattern。 
(5) 更 新 模板 


进入 如 下 目录 : 


openstack dashboard/dashboards/mydashboard/mypanel/templates/mypanel 





更 新 index.html 文 件 : 


($ extends 'base.html' %} 
($ load i18n %} 
($ block title %}{% trans "My Panel" %}{% endblock %} 





($ block page header %} 
($ include "horizon/common/ page header.html" with title- ("My Panel") %} 
($ endblock page header %} 





($ block main $) 
«div class-"row"» 
«div class-"col-sm-12"» 
{{ tab group.render }} 
«/div» i 
«/div» 
($ endblock %} 


oor 


base. html #9 4% 7 openstack_dashboard/dashboards /mydashboard/templates /mydashboard. 





4.Enable 和 show mydashboard 


进入 如 下 目录 : 





openstack dashboard/enabled 


新 建 50 mydashboard.py， 内 容 如 下 : 





# The name of the dashboard to be added to HORIZON['dashboards']. Required. 
DASHBOARD = 'mydashboard' 




















# If set to True, this dashboard will not be added to the settings. 
DISABLED = False 









































# A list of applications to be added to INSTALLED APPS. 
ADD INSTALLED APPS = [ 
'openstack dashboard. dashboards .mydashboard', 














] 


9.3.5 ”验证 代码 


停止 httpd 服 务 ， 然 后 在 一 个 终端 启动 keystone， 命 令 如 下 : 





/usr/bin/keystone-all 


另 一 个 终端 启动 horizon， 命 令 如 下 : 





cd /opt/stack/horizon 
./run tests.sh --runsérver 0.0.0.0:80 





通过 Horizon 的 终端 就 可 以 看 到 相关 的 log 输 出 ， 比 较 直 观 ， 如 图 9-18 所 示 。 


DEBUG:keystoneauth.session:REQ: curl -g -i -X GET http://10.20.0.50:5000/v3/users/80c12bala5/049ac96cc282fb9360a2c/projects -H "User-Ag 
ent: python-keystoneclient" -H "Accept: application/json" -H "X-Auth-Token: ÍSHA1)f2354c/afedc5el0b800862bcef23e8119514596" 
DEBUG:keystoneauth.session:RESP: [200] vary: X-Auth-Token Content-Type: application/json Content-Length: 664 X-Openstack-Request-Id: re 
q-e34a9927-28c6-44a1-a46e-484038062al4 Date: Tue, 11 Oct 2016 18:17:24 GMT Connection: keep-alive 


RESP BODY: { links": ["self": SUR. //10. 20.0.50: 3000/v3/users/80c12bala5/049ac96cc282fb9360a2c/projects", "previous": null, "next": nu 
113, "projects": [í'"is domain": false, "description": "IKS = Uself": "http://10.20.0.50: $000) v3/projetts/ASafalaG0c82427 69440578 
6babb661d6"}, "enabled" true, 3d ie "ASafala60c8a427e94405786abb661d67. "parent id": "default", "domain id": "default", "name": "invisi 
ble to admin", {"is oan" " Ise, "descrip E UA. C RENE x ood 'self": "http: //10.20.0.50: 5000/v3/projects/6225e324 3e6e4a57b048c8400 


162e30fF"}, "enabled": true, " Tus 762256324306e4257b04$c8400162630f" ) "parent id": "default", "domain id": "default", "name": "demo"}]} 


DEBUG: os lo_policy.policy:Rule [telemetry:compute statistics] does not exist 

DEBUG: os lo_policy.policy:Rule [default] does not exist 

DEBUG: os lo_policy.policy:Rule [telemetry:get meter] does not exist 

DEBUG: os lo_policy.policy:Rule [default] does not exist 

[11/0ct/2016 18:17:25] “GET /mydashboard/ HTTP/1.1" 200 19446 

[11/0ct/2016 18:17:25] "GET /dashboard/static/dashboard/css/34f8a8f8d5e5.css HTTP/1.1" 304 0 

[11/0ct/2016 18:17:26] "GET /dashboard/static/dashboard/css/41c0931e8bf3.css HTTP/1.1" 304 0 

[11/0ct/2016 18:17:26] "GET /dashboard/static/dashboard/js/7fd3f7d69c71.js HTTP/1.1" 304 0 

[11/0ct/2016 18:17:26] "GET /dashboard/static/dashboard/js/fd03e79273ca.js HTTP/1.1" 304 0 

[11/0ct/2016 18:17:26] "GET /i18n/js/horizon+openstack_dashboard/ HTTP/1.1" 200 72383 

[11/0ct/2016 18:17:26] "GET /dashboard/static/horizon/lib/bootstrap. RARER GL? TOR ESPDODESEPBB: datepicker.zh-CN.js HTTP/1.1" 304 0 
[11/0ct/2016 18:17:26] "GET /dashboard/static/dashboard/img/logo.png HTTP/1.1" 304 0 

[11/0ct/2016 18:17:26] "GET /dashboard/static/horizon/lib/font-awesome/fonts /fontawesome-webfont. woff2?v=4.3.0 HTTP/1.1" 304 0 
[11/0ct/2016 18:17:26] "GET /dashboard/static/framework/widgets/toast/toast.html HTTP/1.1" 304 0 


图 9-18 Horizon 的 日 志 输 出 


会 在 页 面 上 看 到 相关 的 mydashboard 内 容 ， 如 图 9-19 所 示 。 


a] openstack E invisible to admin * & demo v 


Wn -  Mypanel 


Mydashboard ^ 名 称 状态 可 用 域 m eH 
没有 要 显示 的 条 目 。 
My Group 
Mypanel 
开发 者 
图 9-19 页面 显示 Mypanel 


创建 实例 测试 一 下 (可 以 参考 第 6 章 ) ， 碍 看 是 否 能 显示 内 容 ， 如 图 9-20 所 示 。 


Oo openstack invisible to admin + & demo v 
pa - 实例 
计算 smes- |>| we | osa TE sssr- 
* 口 “实例 名 称 映像 名 称 IP 地 址 大 小 密 钥 对 状态 可 用 域 任务 电源 状态 创建 以 来 的 时 间 操作 
IA 
ni O test cirras-0.3.4-x86 64-uec 172.16.0.11 m1.nano - 活动 nova 无 正在 运行 3 分 钟 创建 快照 v 
Ex 
正在 至 示 1 项 
卷 
E 
访问 & 安全 
Fig 
身份 管理 
Mydashboard 
开发 者 


图 9-20 创建 实例 


添加 实例 后 ，Mypane| 页 面 的 显示 内 容 如 图 9-21 所 示 。 


Mypanel 


O in 状态 可 用 域 Sah 


口 ACTIVE nova cirros-Ü0.3.4-x86. 54-uec 


Displaying 1 item 


图 9-21 Mypanel 页 面 的 显示 内 容 


94 复杂 的 action table 


94.1 定 Xview 


1.template 文 件 


进入 如 下 目录 : 


mypanel/templates/mypanel 


新 建 create snapshot.htmIx fF, ARF: 


($ extends 'base.html' %} 
($ load i18n %} 
($ block title $)[$ trans "Create Snapshot" %}{% endblock %} 





($ block page header %} 
$ include "horizon/common/ page header.html" with title- ("Create a Snapshot") $] 
($ endblock page header %} 





($ block main %} 
$ include 'mydashboard/mypanel/ create snapshot.html' %} 
($ endblock %} 





WEE create snapshot.htmIx fF, ABE: 








$ extends "horizon/common/ modal form.html" %} 
($ load i18n %} 


($ block modal-body-right £j 

<h3>{% trans "Description:" %}</h3> 

<p>{% trans "Snapshots preserve the disk state of a running instance." %}</p> 
$ endblock %} 











2.formx 4t 


进入 mypanel 目 录 ， 创 建 forms.py 文 件 ， 内 容 如 下 : 





from django.core.urlresolvers impor! 
from django.utils.translation impor! 


reverse 
ugettext lazy as . 








ct ct 








from horizon import exceptions 
from horizon import forms 























from openstack dashboard import api 














class CreateSnapshot (forms.SelfHandlingForm) : 
instance id = forms.CharField(label= ("Instance ID"), 
E widget-forms.HiddenInput (), 
required=False) 
name = forms.CharField (max length-255, label= ("Snapshot Name") ) 









































def handle(self, request, data): 
ery: 
snapshot = api.nova.snapshot create (request, 
data['instance id'], 
data['name']) — 
return snapshot 
except Exception: 
exceptions.handle (request, ('Unable to create snapshot.')) 











3.view X 4t 


进入 mypanel 目 录 ， 更 新 view.py 文 件 ， 内 容 如 下 : 


reverse 
reverse lazy 
ugettext lazy as . 





from django.core.urlresolvers impor! 
from django.core.urlresolvers impor! 
from django.utils.translation impor! 














ct eh Gt 








from horizon import tabs 
from horizon import exceptions 
from horizon import forms 























from horizon.utils import memoized 





from openstack dashboard import api 


from openstack dashboard.dashboards.mydashboard.mypanel \ 
import forms as project forms 























from openstack dashboard.dashboards.mydashboard.mypanel \ 
import tabs as mydashboard tabs 











class IndexView (tabs.TabbedTableView): 

tab group class = mydashboard tabs.MypanelTabs 

# A very simple class-based viewhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
template name = 'mydashboard/mypanel/index.html' 





I 






































def get data(self, request, context, *args, **kwargs): 
# Add data to the context herehttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
return context 








I 




















class CreateSnapshotView (forms .ModalFormView) : 

form class = project forms.CreateSnapshot 

template name = ‘mydashboard/mypanel/create snapshot .html’ 
success url = reverse lazy (“horizon:project: images: index’) 
modal id = "create snapshot modal" 

modal header = (“Create Snapshot") 

submit label = ("Create Snapshot") 

submit url = "horizon:mydashboard:mypanel:create snapshot" 





























@memoized.memoized method 

def get object (sel! 
try: 

return api.nova.server get(self.request, self.kwargs[“instance id”]) 

except Exception: 

exceptions.handle(self.request, ("Unable to retrieve instance.”) ) 








— 
. 











def get initial (self): 


return ("instance id": self.kwargs["instance id"]] 
































def get context data(self, **kwargs): 






































context = super(CreateSnapshotView, self).get context data (**kwargs) 
instance id = self.kwargs|[ "instance id'] 

context['instance id'] = instance id 

context [‘instance’] = self.get object () 

context [‘submit_url’] = reverse(self.submit url, args-[instance id]) 

















return context 


为 了 使 代码 具有 更 高 的 可 重复 性 ，Django 实 现 了 模板 系统 ， 把 原始 视图 的 参数 、 返 回 值 及 转换 响应 等 实现 都 包装 成 了 各 种 类 的 方法 。 


94 复杂 的 action table 


94.1 XEVview 


1.templateY f^t 


进入 如 下 目录 : 


mypanel/templates/mypanel 





新 建 create snapshot.htmI fF, PJESSE P: 


$ extends 'base.html' £j 


load i18n $ 





} 


block page header %} 


block title %}{% trans "Create Snapshot" %}{% endblock %} 





$ include "horizon/common/ page header.html" with title- ("Create a Snapshot") $] 


endblock page header %} 


block main %} 


$ include 'mydashboard/mypanel/ create snapshot.html' %} 


endblock %} 





新 建 create snapshot.htmlx fF, ABE: 


$ extends "horizon/common/ modal 1 


($ load i18n % 


} 





($ block modal-body-right £j 
<h3>{% trans "Description:" %}</h3> 


<p>{% trans "Snapshots preserve the disk state of 


($ endblock %} 


2.formx 4t 


Form.html" £) 





f a running instance." %}</p> 





进入 mypanel 目 录 ， 创 建 forms.py 文 件 ， 内 容 如 下 : 


from 





django.core.urlresolvers impor 


from 


from 


django.utils. 


translation import 





horizon import 





from 














t exceptions 
Forms 





horizon impor 





cct 


reverse 


ugettext lazy as . 








from opens! 


class Crea 


instance id = | 


name 


de 





f handle (self, 


tack dashboard import api 











teSnapshot (forms.Sel! 











Forms.CharFie] 


d(label- 


a 


FHandlingForm): 


[nstance 








widget-í 





forms .HiddenInput (), 





required=False) 

















try: 


forms.CharField (max | 





request, data): 


length-255, ] 








ID"), 


snapshot = api.nova.snapshot create (request, 
data['instance id'], 
data['name']) 





return snapshot 





except Exception: 
exceptions.handle (request, ('Unable to create snapshot.')) 


3.view 文 件 


进入 mypanel 目 录 ， 更 新 view.py 文 件 ， 内 容 如 下 : 











reverse 
reverse lazy 




































































from django.core.urlresolvers import 
from django.core.urlresolvers import 
from django.utils.translation import 
from horizon import tabs 
from horizon import exceptions 
from horizon import forms 
from horizon.utils import memoized 
from openstack dashboard import api 
from opens! 

import forms as project forms 
from opens! 

import tabs as mydashboard tabs 
class IndexView (tabs.TabbedTableView): 





tab group class 





























*args, 
text herehttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/0l 


mydashboard tabs.MypanelTabs 
4 A very simple class-based viewht 


template name = 'mydashboard/mypanel/index.html' 
def get data(self, request, context, 

# Add data to the con 

return context 


class Crea 


form class = project 1 








teSnapsho 











templa 








success ur] 





modal id = "create snapshot modal" 





modal header 
submit label = 








(“Create Snapshot”) 
(“Create Snapshot”) 





tView (forms .ModalFormView) : 
forms .CreateSnapshot 
te name = ‘mydashboard/mypanel/create snapshot.html' 
reverse lazy (“horizon:project: images: index”) 


ugettext lazy as . 


tack dashboard.dashboards.mydashboard.mypanel \ 





tack dashboard.dashboards.mydashboard.mypanel \ 


tp: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/0l 


label= ("Snapshot Name")) 


ae 








I 














**kwargs): 


= 








I 








BPS/Text/... 


BPS/Text/... 








submit url = "horizon:mydashboard:mypanel:create snapshot" 


@memoized.memoized method 








def get object (sel! 





— 























.request, 


sel 





f.kwargs["instance id"]) 








_ (“Unable to retrieve instance.")) 
























































f.kwargs["instance id"]] 





self).get context data (**kwargs) 














F.submit url, args-[instance id]) 


try: 
return api.nova.server get(self 
except Exception: 
exceptions.handle (self.request, 
def get initial (self): 
return ("instance id": sel 
def get context data(self, **kwargs): 
context super (CreateSnapshotView, 
instance id = self.kwargs[ instance id'] 
context[' instance id'] = instance id 
context [ ‘instance’ ] self.get object () 
context [ ‘submit url'] = reverse (seli 
return context 





为 了 使 代码 具有 更 高 的 可 重复 性 ，Django 实 现 了 模板 系统 ， 把 原始 视图 的 参数 、 返 回 值 及 转换 响应 等 实现 都 包装 成 了 各 种 类 的 方法 。 


9.4.2 增加 URL 


进入 mypanel 目 录 ， 更 新 urls.py 文 件 ， 内 容 如 下 : 





from django.cons 








F.urls import url 





urlpatterns = [ 
url(r'^$', view 








s.IndexView.as view(), name-'index'), 


url(r'^(?P«instance id»[^/]*)/create snapshot/$', 
views.CreateSnapshotView.as view(), 
name-'create snapshot'), 





from openstack dashboard.dashboards.mydashboard.mypanel import views 





94.3 $gVaction 


进入 mypanel 目 录 ， 更 新 tables.py 文 件 ， 内 容 如 下 : 











from horizon import 


from django.utils.translation import ugettext lazy as - 





tables 








def is deleting (ins! 





tance): 





task state = ge 











if not task sta 





return False 








Ce: 





return task sta 


class CreateSnapsho 


te.lower() == "deleting" 


tAction (tables.LinkAction) : 





name = “snapshot 


verbose name = 


Lr 


(“Create Snapshot”) 


url = "horizon:mydashboard:mypanel:create snapshot" 
classes = ("ajax-modal",) 


icon = "camera" 








def allowed(self, request, instance=None) : 
return instance.status in ("ACTIVE") \ 





and not 




















is deleting (instance) 


class MyFilterAction (tables.FilterAction): 
name = "myfilter" 











class InstancesTable (tables.DataTable): 

















tattr (instance, "OS-EXT-STS:task state", None) 


"Availability Zone") ) 


name = tables.Column("name", verbose name= ("Name") ) 

status = tables.Column("status", verbose name= ("Status") ) 
zone = tables.Column('availability zone', verbose name= ( 
image name = tables.Column('image name', verbose name= (" 


class Meta: 





name = "instances" 
verbose name = ("Instances") 





table actions = (MyFilterAction, ) 


row_actions 


9.4.4 测试 


= (CreateSnapshotAction, ) 





Image Name") ) 


重新 启动 Horizon 服 务 ， 会 看 到 在 Mypanel 页 面 table 的 右 侧 有 一 个 “创建 快照 ”按钮 ， 如 图 9-22 所 示 。 
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图 9-22  Mypanel 页 面 


如 果 虚 拟 机 的 状态 是 active 状 态 ， 单 击 “ 创 建 快照 ”按钮 后 会 弹出 如 图 9-23 所 示 的 创建 快照 页 面 。 


创建 快照 


tum 
snap 


摘 述 : 


& demo ~ 


snapshots preserve the disk state of a running instance. 


图 9-23 ”创建 快照 页 面 


洽 入 “snap” 后 ， 再 单 击 “创建 快照 ”后 会 跳 到 如 图 9-24 所 示 的 页 面 。 





= openstack & invisible to admin v & demo v 


us 、 映像 
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图 9-24 ”映像 页 面 


快照 创建 完成 页 面 如 图 9-25 所 示 。 


J BM 类 型 状态 TB 受 保 护 的 
J snap TES 活动 False False 
Displaying 1 item 


图 9-25 ”快照 创建 完成 


到 这 里 Horizon 的 基本 开发 就 讲 完 了 ， 读 者 需要 多 多 思考 和 练习 ，Openstack 的 版 本 变化 也 会 有 差异 ， 再 次 强调 一 下 本 次 开发 是 基于 Mitaka 版 本 的 DevStack 进 行 的 。 


9.5 Horizon 开发 相关 内 容 


9.5.1 汉化 


本 节 基 于 Devstack 进 行 讲解 。 前 面 的 章节 添加 了 “Mydashboard”， 但 中 文 界面 显示 的 是 英文 ， 很 不 协调 ， 本 节 将 对 Mydashboard 进 行 汉化 。 


进入 如 下 目录 : 





/opt/stack/horizon/openstack dashboard/locale/zh CN/LC MESSAGES 











添加 Mydashboard 的 解析 ， 可 以 参照 原 有 的 内 容 编写 ， 如 图 9-26 所 示 。 


msgid "Settings 





msgstr t 











m 


图 9-26 ”添加 中 文 解析 


msgstr i 


然后 进行 编译 ， 执 行 如 下 命令 : 








msgfmt --statistics --verbose -o django.mo django.po 





将 以 上 文件 复制 到 如 下 目录 : 





/opt/stack/horizon/horizon/locale/zh CN/LC MESSAGES/ 














复制 命令 如 下 : 








cp django* /opt/stack/horizon/horizon/locale/zh CN/LC MESSAGES/ 














重启 httpd 服 务 (或 直接 刷新 页 面 ) ， 然 后 单 击 页 面 菜单 ， 就 会 显示 “我 的 面板 ”， 如 图 9-27 所 示 。 

















图 9-27 汉化 之 后 的 效果 


9.5 Horizon 开发 相关 内 容 


9.5.1 汉化 


本 节 基 于 DevStack 进 行 讲解 。 前 面 的 章节 添加 了 “Mydashboard”， 但 中 文 界面 显示 的 是 英文 ， 很 不 协调 ， 本 节 将 对 Mydashboard 进 行 汉化 。 


进入 如 下 目录 : 





/opt/stack/horizon/openstack dashboard/locale/zh CN/LC MESSAGES 














添加 Mydashboard 的 解析 ， 可 以 参照 原 有 的 内 容 编写 ， 如 图 9-26 所 示 。 


msgid "Settings 





msaqid M 


图 9-26 添加 中 文 解析 


然后 进行 编译 ， 执 行 如 下 命令 : 








msgfmt --statistics --verbose -o django.mo django.po 


将 以 上 文件 复制 到 如 下 目录 : 








/opt/stack/horizon/horizon/locale/zh CN/LC MESSAGES/ 











复制 命令 如 下 : 





cp django* /opt/stack/horizon/horizon/locale/zh CN/LC MESSAGES/ 











重启 httpd 服 务 (或 直接 刷新 页 面 ) ， 然 后 单 击 页 面 菜单 ， 就 会 显示 “我 的 面板 ”， 如 图 9-27 所 示 。 

















9.5.2 workflows 


工作 流 就 是 复杂 的 forms (表单 ) 和 tabs， 每 一 个 workflow 必 须 包 含 Workflow、Sstep 和 Action。 本 节 主 要 讲解 workflow 的 用 法 。 
下 面 先 来 了 解数 据 是 如 何在 urls、views、workflows、templates 之 间 互 相传 递 的 。 


1) 在 urls.py 中 ， 定义 了 一 个 参数 ， 如 resource_class id: 

















RESOURCE CLASS = r'^(?P<resource class id>[*/]+)/%s$' 





urlpatterns = [ 
url (RESOURCE CLASS $ 'update', UpdateView.as view(), name='update') 














] 


2) 在 views.py 中 ， 可 以 传递 数据 到 template 和 action (form) 中 ; action 也 能 够 传递 数据 到 get_context _ data 方法 或 者 template 中 。 








class UpdateView (workflows.WorkflowView): 
workflow class = UpdateResourceClass 











def get context data(self, **kwargs): 
context = super(UpdateView, self).get context data (**kwargs) 
# Data from URL are always in self.kwargs, here we pass the data 
# to the template. 
context ["resource class id"] = self.kwargs['resource class id'] 
# Data contributed by Workflow's Steps are in the 
# context ['workflow'].context list. We can use that in the 
# template too. 
return context 


































































































def get object(self, *args, **kwargs): 

Data from URL are always in self.kwargs, we can use them here 
to load our object of interest. 
esource class id = self.kwargs['resource class id'] 

Code omitted, this method should return some object obtained 
from API. 












































He EH se HE 











def get initial (self): 
resource class = self. get object () 
# This data will be available in the Action's methods and 
* Workflow's handle method. 
4 But only if the steps will depend on them. 
return {'resource class id': resource class.id, 
'name': resource class.name, 
'service type': resource class.service type] 



























































3) 在 workflows.py 中 ， 处 理 数据 (workflows 本 质 就 是 一 个 更 加 复杂 的 Django form) 。 





class ResourcesAction (workflows.Action): 



































# The name field will be automatically available in all action's 

# methods. 

# If we want this field to be used in the another Step or Workflow, 
# it has to be contributed by this step, then depend on in another 
# step. 

name = forms.CharField (max length-255, 





label- ("Testing Name"), 
help text-"", 
required-True) 






















































































def handle(self, request, data): 
pass 
# If we want to use some data from the URL, the Action's step 
# has to depend on them. It's then available in 
4 self.initial['resource class id'] or data['resource class id']. 
# In other words, resource class id has to be passed by view's 
# get initial and listed in step's depends on list. 
# We can also use here the data from the other steps. If we want 
# the data from the other step, the step needs to contribute the 
4 data and the steps needs to be ordered properly. 




















class UpdateResources (workflows.Step) : 
action class - ResourcesAction 
# This passes data from Workflow context to action methods 
# (handle, clean). Workflow context consists of URL data and data 
# contributed by other steps. 
depends on = ("resource class id",) 
































# By contributing, the data on these indexes will become available to 
# Workflow and to other Steps (if they will depend on them). Notice, 
# that the resources object ids key has to be manually added in 

# contribute method first. 

contributes = ("resources object ids", "name") 





















































def contribute(self, data, context): 
# We can obtain the http request from workflow. 












































request = self.workflow.request 
if data: 
4 Only fields defined in Action are automatically 
# available for contribution. If we want to contribute 

















# something else, We need to override the contribute method 

# and manually add it to the dictionary. 

context["resources object ids"] =\ 
request.POST.getlist("resources object ids") 

















# We have to merge new context with the passed data or let 
# the superclass do this. 

context.update (data) 

return context 

















class UpdateResourceClass (workflows.Workflow): 
default steps = (UpdateResources, ) 


























def handle(self, request, data): 
pass 
# This method is called as last (after all Action's handle 
# methods). All data that are listed in step's 'contributes=' 
# and 'depends on=' are available here. 
# It can be easier to have the saving logic only here if steps 
# are heavily connected or complex. 


























# data["resources object ids"], data["name"] and 
# data["resources class id"] are available here. 











9.5.3 JavaScript 


1JavaScript YF 


Javascript 文 件 一 般 是 这 样 开 头 的 : (function () (http://www.hzcourse.com/resource/readBook?path z /openresources/teach ebook/uncompressed/17414/OEBPS/Text/..])) () 。 这 是 


javascrtip 立 即 执行 函数 的 常见 写法 。 


Javascript 中 没有 私有 作用 域 的 概念 。 在 多 人 开发 的 项 目 中 ， 会 在 全 局 或 局 部 作用 域 中 用 到 一 些 变 量 ， 这 些 变量 可 能 会 被 其 他 人 不 小 心 用 同名 变量 给 覆盖 掉 ， 根 据 JjavaSscript 作 用 域 链 的 特性 ， 可 以 模仿 
一 个 私有 作用 域 ， 即 用 匿名 六 数 作为 一 个 “容器 ”， “容器 ”内 部 可 以 访问 外 部 的 变量 ， 而 外 部 环境 不 能 访问 “容器 ”内 部 的 变量 ， 所 以 (function () 
{http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/17414/OEBPS/Text/...}) O 内 部 定义 的 变量 不 会 和 外 部 的 变量 发 生 冲突 ， 这 个 “容器 ” 俗 
称 “匿名 包 囊 器 ”或 “命名 空间 ”。 


2.JavaScript 测 试 

JavaScript 测 试 框架 包含 以 下 几 个 组 件 : 
Jasmine 是 单元 测试 框架 ， 定 义 了 测试 JavaScript 的 语法 和 文件 结构 。 
Karma 是 一 个 基于 Node.js 的 JavaScript 测 试 执 行 过 程 管理 工具 (Test Runner) ， 可 以 用 于 测试 所 有 主流 Web 浏 览 器 。 
` Phantom]JS 提 供 了 一 个 浏览 器 引 学。 


: EsLint 是 一 个 JavaScript 代 码 风 格 检查 工具 。 


//JS tests 

./run tests.sh --karma 

//JS code style checks 

./run tests.sh --eslint 
/ /Coverage 
./run tests.sh --coverage 




















3. 如 何 写 测 试 文件 

这 里 主要 以 Jasmine 为 例 介绍 。Jasmine 使 用 Suites 和 Specs: 
"Suites 开 始 会 调用 一 个 describe， 接 收 两 个 参数 ， 即 stting 和 function。 
Specs 开 始 会 调用 一 个 it。 

JavaScript 测 试 文件 的 扩展 名 应 该 使 用 .mock.js 和 .spec.js。 


Qus 


IRCXInternet Relay Chat 的 英文 缩写 ， 中 文 一 般 称 为 互联 网 中 继 聊 天 。Hotizon 现 在 有 一 个 meeting， 是 Hotizon Team Meeting， 具 体 开会 的 时 间 要 考虑 时 差 问题 。OpenStack 的 会 议 列 表 可 以 参考 下 面 的 链接 


地 址 : http://eavesdrop.openstack.otg/ o 


9.6 ”错误 分 析 


下 面 针 对 本 章 容易 出 错 的 错误 进行 分 析 。 
1.DisallowedHost: Invalid HTTP HOST header 


音 误 提 示 如 下 : 








DisallowedHost: Invalid HTTP HOST header: '10.20.0.50:8080'. You may need to add u'10.20.0.50' to ALLOWED HOSTS. 


解决 方法 : 
1) 进入 如 下 目录 : 


/opt/stack/horizon/openstack dashboard 


2) 编辑 settings.py 文 件 ， 增 加 如 下 内 容 : 





ALLOWED HOSTS = [u'10.20.0.50'] 


2.You have offline compression enabled but key 


音 误 提 示 如 下 : 


























You have offline compression enabled but key "fb4afb57b20494d370c6dcd2051a2f97" is missing from offline manifest. You may need to run "python manage.py compress". 























解决 方法 : 


1) 可 以 按 错误 进行 操作 ， 回 到 Horizon 的 根 目录 ， 执 行 如 下 命令 : 


python manage.py compress 


2) 重新 启动 服务 : 


./run tests.sh --runserver 0.0.0.0:8080 


3.Page not found (404) 


Page not found (404) 的 错误 如 图 9-28 所 示 。 


Page not found (404) 


Request Method: GET 
Request URL: http://10. 20. 0. 50/dashboard/ 


Using the URLconf defined in openstack dashboard urls, Django tried these URL patterns, in this order: 
1. ^$ [name-' splash ] 
2. "api/ 
3. ^home/$ [name= e] 
4. ^il8n/js/ (?P<pa ska ages DDN aaa ' jsil8n'] 
5. ^ e etlang/$ et language'] 
6. “il8n/ 
T 
8 


jas ine-lega cy/$ [name= jasmine tests'] 
ne/.*?$ 


a 
15. “dashboard\/static\/ (?P<path>. *)$ 
1B. ^dashboardVW/ medi aX/ (?P<path>. *)$ 
1T. ^500/f$ 


The current URL, dashboard/, didn't match any of these. 


You re seeing this error because you have DEBUG = True in your Django settings file. Change that to False, 


图 9-28 Page not found (404) 错误 
解决 方法 : 
1) 修改 Horizon 的 配置 ， 让 其 默认 的 访问 路 径 从 “/” 开 始 即 可 正常 。 
执行 : 


vi horizon.dev/openstack dashboard/local/local settings.py 





and Django will display a standard 404 page. 





找到 : 


WEBROOT-" /dashboard/" 














将 其 修改 为 





WEBROOT-"/" 





2) 建议 使 用 httpd 服 务 来 启动 Horizon 服 务 。 
4. 修 改 完 代码 后 页 面 没有 变化 


如 果 修 改 完 代 码 后 页 面 没 有 变化 ， 终 端 也 没有 报错 ， 则 可 查看 一 下 自己 添加 的 代码 是 否 已 经 编译 执行 ， 如 图 9-29 所 示 。 


[stackücontrol mypanel]$ 11 
total 56 


-rw-rw-r-- l stack stack 8/8 Oct 
-rwW-rP--r-- l root root — Oct 
-rw-r--r-- l stack stack 0 Oct 
-rw-r--r-- 1 root root 168 Oct 
-rw-r--r-- l stack stack 801 Oct 
-rw-r--r-- l root root /Ü7 Oct 
-rw-rw-r-- l stack stack 11/78 Oct 
-rw-r--r-- l root root 2470 oct 
-rw-rw-r-- l stack stack 1164 Oct 
-rw-r--r-- 1 root root 7107 oct 
drwxrwxr-x 3 stack stack 20 Oct 
-rw-r--r-- l stack stack 713 Oct 
-rw-r--r-- l stack stack 894 Oct 
-rw-r--r-- l root root 563 Oct 
-rw-r--r-- l stack stack 1982 Oct 
-rw-r--r-- l root root 2951 oct 


编译 后 的 byc 文 件 


03:12 
04:11 
tise. . 
04:11 
01:23 
04:11 
03:13 
04:11 
01:59 
04:11 
01:23 
01:23 
03:13 
04:11 
03:12 
04:11 





— ni t. pyc 
panel.py 
pane l. pyc 
tables.py 
tables.pyc 





tests. py 
uris.py 
uris.pyc 
v1ews.py 
Views . pyc 


97 ”本章 小 结 


本 章 主要 讲解 了 Horizon 的 开发 和 调试 过 程 。Horizon 细 节 比 较 多 ， 读 者 需要 多 看 官方 文档 ， 多 练习 、 多 思考 。 


第 10 章 ”Nova 组 件 


Nova 是 Openstack 云 中 的 计算 组 织 控制 器 。 支 持 Openstack 云 中 实例 (instance) 生命 周期 的 所 有 活动 都 由 Nova 人 处理 ， 这 样 使 得 Nova 成 为 一 个 负责 管理 计算 资源 、 网 络 、 认 证 、 所 需 可 扩展 性 的 平 
台 。 但 是 ，Nova 自 身 并 没有 提供 任何 虚拟 化 能 力 ， 相 反 它 使 用 libvirt APl 来 与 被 支持 的 Hypervisors 交 互 。Nova 通 过 一 个 与 Amazon Web Services (AWS) EC2API3EZIBSWeb Services APl 来 对 外 提供 服 
务 。 


10.1 组 件 介绍 


Nova 组 件 负 责 实 现 计算 功能 。 


10.1.1 OpenStack 的 版 本 


在 使 用 一 个 OpenStack 时 ， 需 要 查看 一 下 OpenStack 的 相关 版 本 ,一般 不 能 直接 看 到 OpenStack 的 版 本 信息 ， 需 要 首先 查 一 下 Nova 的 版 本 ， 然 后 对 比 英文 字母 表 得 到 OpenStack 的 版 本 。 
执行 命令 : 


nova-manage --version 





显示 结果 的 是 13.0.1， 通 过 对 比 字母 表 ， 说 明 Open Stack 是 Mitaka 版 本 。 


10.1.2 ”组 件 的 组 成 


执行 如 下 命令 ， 查 询 Nova 的 服务 : 


/opt/devstack 
. Openrc admin 
nova service-list 





命令 执行 结果 如 图 10-1 所 示 。 


十 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 4+ 一 一 一 一 一 一 一 一 一 + 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 + 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 + 
| Id | Binary | Host | Zone | Status | State | Updated at | Disabled Reason | 
十 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 + 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 圭一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 + 
| 3 | nova-conductor | control | internal | enabled | up | 2016-10-11T16: 56: 22.000000 | - | 
| 4 | nova-scheduler | control | internal | enabled | up | 2016-10-11T16:56:22.000000 | - | 
| 5 | nova-consoleauth | control | internal | enabled | up | 2016-10-11716:56:22.000000 | - | 
| 6 | nova-compute | control | nova | enabled | up | 2016-10-11T16:56:22.000000 | - | 
二 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 + 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 + 


图 10-1 Nova 组 件 查 询 结 果 
Nova 组 件 包括 以 下 主要 服务 : nova-api (图 10-1 中 未 显示 ) . nova-conductor, nova-scheduler, nova-compute, nova-consoleauth, 
(1) API Server 


API Server 对 外 提供 一 个 与 云 基础 设施 交互 的 接口 ， 也 是 外 部 可 用 于 管理 基础 设施 的 唯一 组 件 。 管 理 使 用 EC2API 通 过 Web Services 调 用 实现 。 然 后 API Server 通 过 消息 队列 (message queue) 轮流 
与 云 基础 设施 的 相关 组 件 通信 。 作 为 EC2API 的 另外 一 种 选择 ，Openstack 提 供 一 个 内 部 使 用 的 “Openstack API” , 


(2) nova-conductor 


nova-conductor 是 在 nova-compute 之 上 的 新 的 服务 层 ， 它 使 得 nova-compute 不 再 直接 访问 数据 库 。 涉 及 数据 库 查 询 的 变量 赋值 等 ， 都 是 通过 nova-conductor 这 个 服务 层 实现 的 ， 这 个 服务 层 实 际 
上 增强 了 代码 的 可 扩展 性 和 安全 性 。 


(3) nova-scheduler 


nova-scheduler 主 要 完成 虚拟 机 实例 的 调度 分 配 任务 ， 如 创建 虚拟 机 时 ， 虚 拟 机 该 调度 到 哪 台 物理 机 上 。 若 迁移 时 没有 指定 主机 ， 也 需要 经 过 nova-scheduler。 资 源 调度 是 云 平台 中 的 一 个 很 关键 问 
题 ， 如 何 做 到 资源 的 有 效 分 配 ， 如 何 满足 不 同情 况 的 分 配方 式 ， 这 些 都 需要 由 nova-scheduler 来 掌控 ， 并 且 能 够 很 方便 地 扩展 更 多 的 调度 方法 ， 可 能 需要 将 虚拟 机 调度 到 空闲 的 机 器 ， 可 能 还 需要 将 某 类 型 
的 虚拟 机 调度 到 固定 的 机 架 等 。 


(4) nova-compute 


nova-compute 处 理 管理 实例 生命 周期 。 它 们 通过 消息 队列 接收 实例 生命 周期 管理 的 请 求 ， 并 承担 操作 工作 。 一 个 典型 生产 环境 的 云 部 署 中 有 一 些 compute workers。 一 个 实例 部 署 在 哪个 可 用 的 
compute worker 上 取决 于 调度 算法 。 


(5) nova-consoleauth 


nova-consoleauth 提 供 token 验 证 ， 维 护 token 与 iP 地 址 、 端 口号 的 映射 。 


10.1.3 组 件 之 间 的 天 系 


组 件 之 间 的 关系 如 图 10-2 所 示 。 





图 10-2” 组件 之 间 的 关系 


外 部 服务 全 部 通过 restfu| 提 供 可 供 访 问 和 操作 的 API 接 口 ，API 负 责 进 行 前 端 请 求 的 相应 处 理 ; Nova-conductor 负 责 数 据 库 的 写 入 和 查询 ;Nova-scheduler 负 责 资源 的 调度 和 分 配 ; Nova-compute 
负责 VM 的 管理 ;， 所 有 组 件 之 间 通 过 消息 队列 进行 通信 。 


10.1.4 API 的 使 用 
在 命令 行 输 入 如 下 命令 : 


nova --help 





执行 后 会 列 出 所 有 的 Nova API， 图 10-3 所 示 只 是 其 中 部 分 示例 。 


Command-line interface to the OGpenStack Nova API. 


Positional arguments: 


<5 ubcommand> : 
absolute-limits DEPRECATED, use limits instead. 
add-fixed-ip Add new IP address on a network to server. 
add-floating-ip DEPRECATED, use floating-ip-associate instead. 
add-secgroup Add a Security Group to a server. 
agent-create Create new agent build. 
agent-delete Delete existing agent build. 
agent-list List all builds. 
agent -modify Modify existing agent build. 
aggregate-add-host Add the host to the specified aggregate. 
aggregate-create Create a new aggregate with the specified 


details. 


图 10-3 #84 Nova API 


调用 image-list 的 AP1， 如 图 10-4 所 示 。 


[rootücontrol devstack]# nova image-list 


十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 + 
| ID | Name | Status | Server | 
二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 手 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 + 
| dad652dc 058b -4b84- 82f8- beb0976b6e25 | cirros-0.3. 4- x86_64-uec | ACTIVE | | 
| 4//92a/8-43/b-4A18b-88f8-49/68ece92Af | cirros-0.3.4-x86 64-uec-kernel | ACTIVE | | 
| 《7 de4404- 5993-A1fÜ0- 8011- ddëebë/ 37/433 | cirros-O. 3. "s x66 —64- uec-ramdisk | ACTIVE | | 
十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 盾 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 + 


图 10-4 Nova image-list 2% Æ 


调用 net-list 的 APl， 如 图 10-5 所 示 。 


[rootWconEno] devstack e nova net-list 


十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 4 
| ID | Label | CIDR | 
十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 


| 2a90af15 -75bf -4070- 8911- 7176539c9b00 | public | None | 
| FE A EE: -Ac3b- sanl DT A EM | private | None | 


图 10-5 Nova net-list 25 Æ 


oor 


管理 员 可 以 使 用 所 有 的 API， 首 通用 户 使 用 的 API 会 有 权限 的 限制 。 


10.2 ”虚拟 创建 过 程 评 解 


OpenStack 最 核心 的 是 实例 的 启动 ， 下 面 以 一 个 实例 的 启动 为 例 详细 讲解 实例 的 启动 调用 过 程 ， 如 图 10-6 所 示 。 



























































图 10-6 ”实例 启动 请 求 流程 


iz: 图 片 来 源 于 官方 网 站 

10-6 所 示 的 各 组 件 介绍 如 下 : 
:Clinet 是 命令 行 接口 ; 
- keystone 提 供 所 有 组 件 的 认证 (认证 后 端 是 LDAP) ; 
: nova 开 头 的 代码 计算 组 件 相 关内 容 ; 


neutron 开 头 的 代表 网 络 组 件 相 关内 容 ; 


:cindet 开 头 的 代表 块 存 储 组 件 相 关内 容 ; 


.glance 开 头 的 代表 镜像 组 件 相 关内 BS; 


: MQ 为 消息 队列 组 件 ， 用 于 组 件 内 部 通信 。 


创建 实例 的 基本 流程 (参见 图 10-6) WTF: 


1) 实行 认证 。 


2 


— 


3 


— 


4 


— 


5 


— 


6 


— 


7 


— 


8 


— 


9 


— 


10 


— 


11 


— 


12 


— 


13 


— 


14 


— 


15 


— 


16 


— 


17 


— 


18 


— 


19 


— 


20 


— 


21) 


22) 


23) 


24) 


25) 


26 


— 


27) 


28) 


认证 成 功 返 回 一 个 token。 

发 起 启动 实例 的 请 求 。 

nova-api 接 收 到 请 求 ， 验 证 token 是 否 合法 。 
Keystone 返 回 验证 结果 。 

nova-api 调 用 数据 库 接 入 ， 写 入 虚拟 机 的 相关 信息 。 
创建 相关 记录 。 

nova-api 发 送 请 求 组 ，nova-scheduler 得 到 主机 ID。 


nova-scheduler 从 消息 队列 接收 到 消息 。 


nova-scheduler 根 据 filtering 和 weighing 查 询 数据 库 。 

根据 filtering 和 weighing 返 回 主机 ID。 

nova-scheduler 返 回 确认 启动 实例 的 物理 主机 。 
nova-compute 收 到 请 求 。 

nova-compute 收 到 信息 并 到 数据 库 得 到 实例 的 相关 信息 。 
nova-conductor 收 到 请 求 。 

nova-conductor 调 用 数据 库 。 

返回 实例 信息 。 

nova-compute 从 消息 队列 得 到 实例 的 相关 信息 。 

nova-compute 带 着 token 调 用 glance-api 获 取 镜 像 ID ， 得 到 镜像 的 URL。 
glance-api 验 证 token。 

nova-compute 得 到 镜像 的 数据 。 

nova-compute 带 着 token 去 调用 neutron-api 实 例 的 IP 地 址 。 
neutron-server 验 证 token。 

nova-compute 获 取 网 络 信息 。 

nova-compute 带 着 token 去 调用 cinder-api 加 载 实例 的 磁盘 。 
cinder-api 验 证 token。 

nova-compute 得 到 存储 信息 。 


nova-compute 调 用 底层 libvirt 驱 动 启动 实例 。 


启动 步骤 的 分 类 如 表 10-1 所 示 ， 仅 供 参 考 。 


表 10-1 


启动 步骤 


^ 
分 


状态 
Build 
Build 
Build 
Build 








Active | none Running 


10.3 Nova 源码 分 析 


本 节 开 始 分 析 Nova 的 源码 结构 ， 需 要 把 Nova 工 程 导入 PyCharm 中 。 


10.3.4. 目录 结构 


= nova (D: Vapenstack:nova-mi take nova) 
| EI- DÀ spi- gui de 
由 : [1 contrib 
由 [1 devstack 
E [1 doc 
由 : [^] etc 
由 [*] nova 
由 P| nova. egg-info 
由 Pl plugins 
E M] releasenotes 
由 [7] tools 
Pe e 


== [=| . coveragerc 





=| .gitignore 


=- |E] . gitreview 

ji [=] .mailmap 

— [E] . testr. conf 

— [E] babel. cfg 

— [E] bandit. yanl 

- ist CONTRIBUTING. rst 
ist HACKING. rst 

=| LICENSE 


E [=] openstack-common cont 








-B 
5 E run tests. sh 
5 


— [s| setup. cfg 


c DE sita 

! test-requirementz. txt 
ji tests- py3. txt 

is tox. inl 





图 10-7 Nova 源码 结构 
1. 根 目录 文件 说 明 
tox.ini: 代码 构建 的 配置 文件 。 
test-requirements.txt: 生成 测试 环境 的 依赖 包 列 表 。 
requirements.txt: 当前 环境 的 依赖 包 列 表 。 
setup.py: 打包 工具 。 


setup.cfg: 函数 和 命令 的 对 应 关系 ， 如 图 10-8 所 示 。 


console scripts = 


nova-all 


nova. cmd. all: main 


LOWS api = nòva cmd api malir 





nowva-api-metadata = nova. cmd. api metadata:main 
nava-api-os-compute = nova. cmd. api os compute: main 
nova cells = nova. cmd. cellz:main 

nova-cert = nova. cmd. cert: main 

nova compute = nova. cmd. compute: main 

nova conductor = nova. cmd. conductor = main 
nova-console = nova. cmd. console: main 
nova-consoleauth = nova. cmd. consoleauth:main 

nova -dhcpbridge = nova. cmd. dhcpbridge:main 
nova-idmapshift = nova. cmd. 1dmapshift:main 


nova manage 一 Towa. cm d. manage. main 


nova-network = nova. cmd. network: main 


nova Nowe proxy = nova. cmd. nowneproxy: main 


nova-rootwrap = oslo rootwrap. cmd:main 
nova-rootwrap-daemon = oslo rootwrap. cmd: daemon 


nova scheduler = nova. cmd.scheduler:main 


nova-serialproxy = nova. cmd serialproxy:main 
nova-spicehtmloproxy = nova. cmd. spicehtmloproxy:main 


nova-xvpvncproxy = nova. cmd. xvpyneproxy main 


图 10-8 Nova 命令 和 函数 的 对 应 关系 


图 10-8 中 阴影 处 对 应 程序 中 的 nova/cmd/api.py/main () ， 如 图 10-9 所 示 。 


BI- IN mova El 

| BI [cA | 
由 -的 api Hamper imi 
fF] cells : 
由 -加 cert 


: = pł Ci 
UM an CONF = cfg CONF 


-E 


: CONF. import_opt Ë enabled apis , mova service ) 





l 
- n 
^h. 
pu 


| init .py : CONF. import opt( emabled_ssl_spis , "nova service ) 
Re B all py : 





i, api metadata. py 





mdef maini): 





- ly api_os_compute. py : ; : 
a DE SERRE vw : config. parse args (sys. argv! 
= a cells py : logging. setup (CONF, "nowa") 


图 10-9 ”源码 的 代码 位 置 


对 于 大 型 的 开源 项 目 ， 建 议 先 不 要 研究 细节 ， 先 抓 住 纲 要 。 对 于 简单 项 目 ， 基 本 要 求 是 能 够 对 代码 进行 简单 的 修改 。 开 始 学 习 程序 主要 掌握 组 件 间 的 调用 关系 ， 以 上 是 程序 的 入 口 ， 也 是 研究 程序 的 开 


2. 主 目录 说 明 


下 面 对 主 目录 进行 说 明 ， 如 图 10-10 所 示 。 


nova/ 

I—— api-guide (API 手 册 ) 

I—— doc (相关 文件 ) 

| 一 一 etc( 配置 文件 相关 的 内 容 ， 包 括 policyjson 权限 的 策略 文件 ) 

I—— nova (最 重要 的 部 分 ， 是 Nova 各 个 组 件 的 代码 ， 根 目录 下 的 文件 中 各 个 组 件 都 | 会 用 的 模块 ) 
上 一 一 api (接收 和 响应 客户 的 API 调用 。 除 了 提供 OpenStack 自己 的 API, nova-api 还 支持 Amazon EC2 API) 
| 一 一 CA (与 认证 和 授权 相关 的 内 容 ) 

I-—— cells (多 个 OpenStack 在 一 起 会 用 到 ) 

I-—-— cert (证 书 相 关 的 内 容 ) 

I-—— cloudpipe (为 project 创建 VPN 服务 需 的 代码 ) 
I-—— cmd (与 进程 相关 的 内 容 ) 

I-—— common (公共 内 容 ) 

上 -一 一 compute (提供 虚拟 机 的 相关 操作 和 调用 ) 
I-—— conductor (数据 的 相关 操作 ) 

I-—— conf (与 虚拟 机 配置 文件 调用 相关 的 内 容 ) 
I-—— console (虚拟 机 console 相关 的 内 容 ) 

H—— consoleauth (虚拟 机 日 志 的 获取 ) 

上 一 一 db (数据 库 表 结构 ， 表 调用 接口 封装 ， 主 要 使 用 的 是 sqlalchemy ) 
上 一 一 hacking 

H—— image (与 镜像 相关 的 内 容 ) 

上 一 一 ipv6 (IPv6 的 相关 操作 ) 


上 一 一 keymgr 

I-—— locale (本 地 语言 目录 ) 

[-—— mks 

I-—— network (nova network 实现 的 网 络 ) 
I-——— objects 


| 一 一 OpenStack (使 用 源码 安装 文件 ) 
I-—— pei (PCI 总 线 的 相关 调用 ) 


I-—— rdp 
I-—— scheduler (任务 调度 模块 ， 包 括 重要 的 filters 和 weights) 
上 一 一 Servicegroup 


H—— spice (桌面 协议 ) 

上 -一 一 tests (单元 测试 的 所 有 实现 ) 

H—— virt (虚拟 化 库 的 所 有 实现 ， 包 含 libvirt、xenserver、vcenter 等 ) 
I-—— vne (虚拟 机 vne 控制 台 的 服务 端 实现 ) 

一 一 volume ( 块 存储 ) 


L—— wsgi 


图 10-10 EH 


oor 


版 本 不 同 ， 目 录 可 能 会 有 所 不 同 。 


10.3.2 重要 目录 详解 


重要 目录 包括 api、db、scheduler 等 ， 这 里 重点 讲解 db、scheduler 目 录 。 
1.db 详 解 


db 目录 结构 如 图 10-11 所 示 。 


I~ 的 dh 
: [i m sglalchemy 
| El [7] api migrations 
à Emigrate repo 
B. init pF 
A. api. py 
api models. py 





F migration. py 
: models. py 
à tvpes.pv 
utils. py 


图 10-11 db 目录 结构 











双击 models.py 并 单 击 左上 角 的 structure， 会 显示 程序 的 函数 结构 ， 双 击 一 个 选项 (如 Console) 可 以 看 到 该 表 的 结构 ， 如 图 10-12 所 示 。 


"E dl. 
dS F 






^e PLLA PL SINS ple rr, Li PaaS, HIMES. SL LE Let ALLY 


H- (E) Cell (BASE, Novabase, models. SoftDeleteMixin) 

H- (E. Certificate (BASE, HovaBase, models.SoftDeleteMixin) 
H- (E) ComputeNode (BASE, HovaBase, models.SoftDeleteMixin) 
— UD CONF 

E d NU HovaBase, models. SoftDeleteMixin) 


| copy (self) 


Kn l: Project 


| table args — 


| tablename - 


ali s Structure | 





图 10-12 #2544 


登录 数据 库 进 行 验证 : 





数据 库 的 密码 : stackdb (在 local.conf 中 查 得 ) 
mysql -u root -pstackdb 

use nova 

desc consoles; 





命令 的 执行 结果 如 图 10-13 所 示 。 


Mar1aDB [nova]> desc consoles; 


十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 + 
| Field | Type | Null | Key | Default | Extra | 
十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 
| created. at | datetime | YES | | NULL | | 
| updated at | datetime | YES | | NULL | | 
| deleted at | datetime | YES | | NULL | | 
| id | int(11) | NO | PRI | NULL | auto_increment | 
| instance_name | varchar(255) | YES | | NULL | | 
| password | varchar(255) | YES | | NULL | | 
| port | int(11) | YES | | NULL | | 
| pool. id | int(11) | YES | MUL | NULL | | 
| instance uuid | varchar(36) | YES | MUL | NULL | | 
| deleted | int(11) | YES | | NULL | | 
十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 十 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 + 


10 rows in set (0.00 sec) 
图 10-13 Big E 2544 


单 击 该 目录 下 的 api.py 文 件 并 在 structure 模 式 下 查看 该 文件 ， 如 图 10-14 所 示 。 


Structure T HO | r Ir 


Project 





aS flavor get id from flavor query (context, flavor id) 
p — mb | flavor get query (context, read deleted-llone) 


mil 





be "ni floating ip count by project (context, project id) 





| floating ip get all (context) 

"n: floating ip get by address(context, address) 

in from legacy values (values, legacy, allow updates=False) 

get associated fixed ips query (context, network id, host=None) 


Es "n get db conf (conf group, connection-llone) 


aÏ T: Structure 


i) get project user quota usages(context, project_id, user id) 
ps n get regexp op for connection(dh connection) 

m ni handle objects related type conversions (values) 

bs ni instance data get for userícontext, project id, user id) 


E on _instance_extra_create (context, values) 


i) instance get all query (context, project only-False, joins-Hone) 





instance get all uuids by host (context, host) 
Pe on instance get hy unidi(context, uuid, columns to join-llone) 
Pe "n. instance group count by project and user (context, project id, user 


in instance group get query (context, model class, id field=None, id=! 





bs on instance group id(context, group uuid) 


Mi: 


图 10-14 调用 数据 的 方法 


oor 


代码 查看 工作 使 用 PyCharm 实 现 ， 所 有 数据 库 的 API 操 作 都 在 这 里 了 。 
2.scheduler 详 解 

scheduler 目 录 结 构 如 图 10-15 所 示 。 

filters 目 录 是 所 有 的 过 滤 算 法 ， 如 图 10-16 所 示 。 

filters 和 weights 的 关系 如 图 10-17 所 示 。 


先 过 滤 掉 一 些 不 满足 条 件 的 主机 ， 然 后 交 给 weights 进 行 选 择 。 这 里 的 选择 主要 是 指 根据 经 济 性 进行 排序 。weights 的 原理 如 图 10-18 所 示 。 
[=I scheduler 


由 [£7] client 
T laJ filters 


| E-É5 wei ighta 
D im affinity.py 

















— M disk py 

10 ops. pY 
Æ metrics. py 
MÀ. ram. py 

|. int .py 


E 
EEREES B&B 








- caching scheduler. py 
- chance. py 

- driver. py 

- filter scheduler. py 
ii host manager.py 

e rp ironic host manager. py 
z manager. py 

- rpeapl - EY 

scheduler options. py 


-" utils. py 


图 10-15 scheduler B 3& 2544 


=e Filters 
a affinity filter. py 


EEE EEE 


aggregate image properties isolat 


SEE EES | 


| aggregate instance extra specs. py 


EBEEESS 


wm aggregate multitenancy isolation 
i; all hosts filter. py 
b availability zone filter. py 
lh compute capabilities filter. py 
A. compute filter. py 
wh core filter. py 
wh disk filter py 


lh exact core filter. py 


— B exact disk filter. py 


À exact ram filter. py 
Bextra specs ops. py 

A, image props filter. py 

À io ops filter. py 

A isolated hosts filter. py 
A json_filter. py 
A metrics filter. py 

i, num instances filter. py 
À numa topology filter. py 
À pci passthrough filter. py 
a ram filter. py 

A retry filter. py 

A. trusted filter. py 
WE type filter py 
wh utils. py 


图 10-16 filters E 3x X fF 









经 过 过 滤 和 权重 分 析 
Ja host 5 Æ fe È AY, 
host 6 是 最 差 的 


图 10-17  filters#eweights 9 X A 


Cost 


主机 池 





图 10-18 weights JR #2 


ik: 图 片 来 源 是 OpenStack 官 方 网 站 


10.4 Nova 调 用 关系 分 析 


本 节 讲 述 源 代码 之 间 的 调用 关系 ， 可 能 因为 不 同 的 Nova 版 本 会 有 差异 。 


10.4.1 ”创建 虚拟 机 过程 源 码 奶 溯 


创建 虚拟 机 过 程 中 Nova 所 涉及 的 文件 和 函数 的 调用 关系 如 下 。 


1) nova-api 的 调用 关系 如 下 : 


process stack /opt/stack/nova/nova/api/openstack/wsgi.py 

create extension point /opt/stack/nova/nova/api/openstack/compute/servers.py 
validate networks /opt/stack/nova/nova/network/neutronv2/api.py 
http log request /usr/local/lib/python2.7/dist-packages/keystoneauthl/session.py 
get quotas /opt/stack/nova/nova/quota.py 

reserve /opt/stack/nova/nova/quota.py 

refresh quota usages /opt/stack/nova/nova/db/sqlalchemy/api.py 

quota reserve /opt/stack/nova/nova/db/sqlalchemy/api.py 

provision instances /opt/stack/nova/nova/compute/api.py 

Check effective sql mode /usr/local/lib/python2.7/dist-packages/oslo db/sqlalchemy/engines.py 
. create | block device mapping /opt/stack/nova/nova/compute/api.py 

commit /opt/stack/nova/nova/quota.py 









































2) nova-conductor 的 调用 关系 如 下 : 





create /usr/local/lib/python2.7/dist-packages/oslo messaging/ drivers/pool.py 
init /usr/local/lib/python2.7/dist-packages/oslo messaging/ drivers/impl rabbit.py 




















3) nova-scheduler 的 调用 关系 如 下 : 


create /usr/local/lib/python2. 7/dist-packages/oslo messaging/ drivers/pool.py 
init /usr/local/lib/python2.7/dist-packages/oslo messaging/ drivers/impl rabbit.py 
inner /usr/local/lib/python2.7/dist-packages/oslo concurrency/lockutils.py 
locked update /opt/stack/nova/nova/scheduler/host manager.py 
get filtered objects /opt/stack/nova/nova/filters.py 
Schedule /opt/stack/nova/nova/scheduler/filter scheduler.py 
inner /usr/local/lib/python2.7/dist-packages/oslo concurrency/lockutils.py 
numa fit instance to host /opt/stack/nova/nova/virt/hardware.py 
create /usr/local/lib/python2.7/dist-packages/oslo messaging/ drivers/pool.py 
init /usr/local/lib/python2.7/dist-packages/oslo messaging/ drivers/impl rabbit.py 








































































































4) nova-compute 的 调用 关系 如 下 : 


inner /usr/local/lib/python2.7/dist-packages/oslo concurrency/lockutils.py 
do build and run instance /opt/stack/nova/nova/compute/manager.py 
create /usr/local/lib/python2. 7/dist-packages/oslo messaging/ drivers/pool.py 
init /usr/local/lib/python2.7/dist-packages/oslo messaging/ drivers/impl rabbit.py 
instance claim /opt/stack/nova/nova/compute/resource tracker.py 
build resources /opt/stack/nova/nova/compute/manager.py 
allocate network async /opt/stack/nova/nova/compute/manager.py 
.http log request /usr/local/lib/python2.7/dist-packages/keystoneauthl/session.py 
volume in mapping /opt/stack/nova/nova/block device.py 
.build resources / opt/stack/nova/nova/compute/manager .py 
allocate for instance /opt/stack/nova/nova/network/neutronv2/api.py 
# http log request /usr/local/lib/python2.7/dist-packages/keystoneauthl/session.py 
read cached file /usr/local/lib/python2.7/dist-packages/oslo policy/ cache handler.py 
| load policy file /usr/local/lib/python2.7/dist-packages/oslo policy/policy.py 
enforce /opt/stack/nova/nova/policy.py 
# http log request /usr/local/lib/python2.7/dist-packages/keystoneauthl/session.py 
build and run instance /opt/stack/nova/nova/compute/manager.py 
volume in mapping /opt/stack/nova/nova/block device.py 
get auth ref /usr/local/lib/python2.7/dist-packages/keystoneauthl/identity/v3/base.py 
execute /usr/local/lib/python2.7/dist-packages/oslo concurrency/processutils.py 
fetch to raw /opt/stack/nova/nova/virt/images.py 
execute /usr/local/lib/python2.7/dist-packages/oslo concurrency/processutils.py 
Create port /opt/stack/nova/nova/network/neutronv2/api .py 
get instance nw info /opt/stack/nova/nova/network/neutronv2/api.py 
can resize image /opt/stack/nova/nova/virt/disk/api.py 
| get | preexisting | port ids /opt/stack/nova/nova/network/neutronv2/api.py 
#can_ resize image /opt/stack/nova/nova/virt/disk/api.py 
update instance cache with nw info /opt/stack/nova/nova/network/base api.py 
lock /usr/local/lib/python2.7/dist-packages/oslo concurrency/lockutils.py 
allocate network async /opt/stack/nova/nova/compute/manager.py 
obj load attr /opt/stack/nova/nova/objects/instance.py 
get guest xml /opt/stack/nova/nova/virt/libvirt/driver.py 
#obj load attr /opt/stack/nova/nova/objects/instance.py 
get desirable cpu topologies /opt/stack/nova/nova/virt/hardware.py 
get cpu topology constraints /opt/stack/nova/nova/virt/hardware.py 
get possible cpu topologies /opt/stack/nova/nova/virt/hardware.py 
Supports | direct io /opt/stack/nova/nova/virt/libvirt/driver.py 
get config /opt/stack/nova/nova/virt/libvirt/vif.py 
to xml /opt/stack/nova/nova/virt/libvirt/config.py 
prepare for instance event /opt/stack/nova/nova/compute/manager.py 
plug /opt/stack/nova/nova/virt/libvirt/vif.py 
plug bridge /opt/stack/nova/nova/virt/libvirt/vif.py 
spawn /opt/stack/nova/nova/virt/libvirt/driver.py 
get power state /opt/stack/nova/nova/compute/manager.py 


oon 


由 于 篇 幅 关 系 这 里 没有 载 图 说 明 ， 读 者 可 自己 根据 顺序 阅读 源码 。 


















































































































































































































































































































































10.4.2 ”创建 虚拟 机 过 程 调用 流程 疯 数 分 析 


同 用 遂 数 关系 ， 如 图 10-19 所 示 。 





nova.apl.openstack.compute.servers nova.scheduler.DriverX XX nova.compute.manager nova.virt.driver 


get available nodes() 









create() schedule run instance() run instance() 


* extract params to API call(name,personality,flavorid,etc.) * defaults to nova.scheduler.filter_scheduler _prebuild_instance() * returns the hyper itself normally 






* basic param validation * calls actual schedulers * update instance status in DB * can return multiple for baremetal 






* calls a few nova extensions(os-config-drive,os-networks...) * get image metadata using glance client macs for instance() 






* get ref to flavor if passed in build instance() * build and return mac for hyper instance 






* if None returned it will be done automatically 
spawn()PER VIRT DRIVER HYPER 


[sample considerations] 


* call nowa.compute.api.create() * call driver.get avail nodes() 
* get BDM from DB 


* de code injected files 








* driver.macs for instance( * verify vm does not exist 






* create root disk 





* allocate network() 






create() 















** calls into nova network.api * use hyper APIs to create new VM 


create instance() 













* setup block device mapping() e e specify ram,cpu,etc 
** expand BDMs 


* if snapshot+vol,call into cinde\ to cyéate()new vol 


* get image details image Ref using glance conductor to run instance on manager 


* attach root disk to vm 


* get vol details BDM using cinder client( 
* create iS CSI controller 







* validate & default some params 


** if vol call cinder.check attach( * create and plug VIF 


save instance state to DB 





** if volcall attach volume boót()which calls attach() * setup config drive 





call conductor to schedule instance 






_spawn() 









* update instance to DB 


* call driver,spawn() 


nova.network.neutronv2.api 


allocate for instance() 





nova.image.glance(client) nova.volume.cinder(client) 


get() 
* call into cinder to get vol using REST API 


nova.network.neutronv2.api(client) \ 


show_port() 





* if network is given, call into neutron client to show port() 


details() 
* call into glance using REST API 


* call into neturon using REST API to get port * validate hypervisor MACS if given against port 


list security groups() * calls get available networks() 


* call into neutron REST to list sec groups * ifsecurity groups is given,call into client to list security groups() 


show() create() 


* call into glance to show using REST 





* call into cinder to create vol 


check attach() 

* call cinder check attach REST API 
attach() 

* call inder attach REST API 


1 create port() e » create ports as needed using client create port..includes secunity,mac,etc. 


list networks() e » collect security groups based on params passed into method 


* call into neutron REST to list nets 
* for each network 


update port() 


« call into neutron to update a port » » update desired ports using client update port() 


* call into neutron to create a port * return a Nework modle object with updated network info 





* get available networks() 


* call into neutron client list networks() 





filter based on project-shared--ID if given 


图 10-19 ”调用 函数 关系 图 
ik: 图 片 来 源 http://bodent.blogspot.com/ ，Ocata 版 本 可 能 发 生 了 变化 
图 例 说 明 如 表 10-2 和 表 10-3 所 示 。 


表 10-2 颜色 说 明 


颜色 组 件 类 型 


Yellow Controller classes for nova API 

Pink Nova scheduler classes 

Green Nova manager (framework) classes 

Cyan Nova virt driver (implemented per hypervisor type) 

Grey Clients used by the various nova classes to interface with other services via REST API 


Red Other OpenStack services 
表 10-3 ”调用 接口 说 明 
线 型 接口 类 型 
Solid black Python API call 


Black dashed REST API call 
Reddish solid AMQP 


i: 由 于 中 英文 的 差异 ， 这 里 暂 不 做 翻译 ， 读 者 可 以 根据 图 的 调用 关系 去 阅读 Nova 的 代码 ， 验 证 一 下 相关 流程 是 否 正确 。 


10.4.3 Nova 和 AMQP 的 关系 


1.AMQP 


AMQP 是 一 种 信息 传送 协议 ，RabbitMQ 是 这 种 协议 的 一 个 开源 实现 ， 可 以 让 Nova 组 件 之 间 采 取 一 种 低 耦合 的 方式 实现 RPC 通 信 。Nova 采 用 的 信息 交互 方式 有 三 种 : 直 连 、 分 列 Fanout (消息 会 被 传 
递 到 所 有 绑 定 的 队列 上 ) 、 基 于 主题 


Nova 通 过 提供 一 个 适配器 来 封装 和 解 封 发 送 消息 ， 实 现 了 RPC (rpc.callffirpc.cast) 。 每 一 种 Nova 服 务 (compute, scheduler, cert, conductor, consoleauth) 在 初始 化 的 时 候 ， 初 始 化 两 个 队 
列 : @ 接 收 NODE-TYPE.NODE-ID 类 型 路 由 key 消 息 的 队列 ; @ 接 收 NODE-TYPE 类 型 路 由 key 消 息 的 队列 。 


2.Nova RPC 映 射 
每 个 Nova 组 件 连 接 到 RabbitMQ， 可 能 会 将 消息 队列 当 作 一 个 invoker 或 者 worker。invoker 通 过 rpc.cal| 或 者 rpc.cast 的 方式 向 队列 当中 发 消息 ，worker 接 收 队列 当中 的 消息 来 应 答 。 


单一 虚拟 机 的 环境 消息 队列 如 图 10-20 所 示 ， 包 括 直接 和 基于 主题 两 种 。 


| 
| 一 一 一 一 | TTY eh 
Consumer 








| 
| 
| | | 
| Topic 
key:topic | | 
| Publisher | | | 
| Topic 
| | name:control exchange | 
| bui | Consumer | 
| | (type:topic) key:topic.host | | 
| 
| | | 
| Direct | I » | Direct | 
| Consumer | Publisher | 
Ee | key:msg id name:msg id | ————— | 
invoker (type:direct) worker 


(e.g.compute) 


(e.g.api) RabbitMQ Node 


图 10-20 消息 队列 示例 图 
3.AMQP 实 践 


列 出 所 有 的 exchanges 的 名 字 ， 命 令 及 结果 如 下 : 


# rabbitmqctl list exchanges name 

Listing exchanges http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
reply 1653ecdea94d471dbbc2d43a53c8508a 

amq.rabbitmq.trace 

consoleauth fanout 
compute fanout 
q-reports-plugin fanout 

reply 41f7f558bb44490da48fd4ec12fa8e00 
q-13-plugin fanout 
amq.fanout 
q-agent-notifier-security group-update fanout 
reply 2786ca621e6345d4p79145709c4pd549 
q-agent-notifier-tunnel-update fanout 
cinder-volume fanout 

glance 

amq.topic 

openstack 

amq.direct 

amq.headers 

amq.match 














































































































reply f55a4a857da1443c80423fe9bb707a47 
nova 
q-agent-notifier-network-update fanout 
neutron 
q-agent-notifier-port-update fanout 
q-server-resource-versions fanout 
13 agent fanout 
q-agent-notifier-tunnel-delete fanout 
conductor fanout 
q-agent-notifier-dvr-update fanout 
q-plugin fanout 
reply 29eabc9e9dfa496d9clea4cf80fd4q70 
amq.rabbitmq.log 
q-agent-notifier-port-delete fanout 
cinder-scheduler fanout 

Scheduler fanout 

dhcp agent fanout 





























































































































列 出 所 有 的 queues 的 名 字 ， 命 令 及 结果 如 下 : 





# rabbitmqctl list queues name 

Listing queues http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/... 
conductor.control 
q-agent-notifier-tunnel-delete fanout db55ad56db394f55b3b8a2ca366c9418 
q-plugin 
cinder-scheduler fanout 5b8a5e3b5d9e462eb01485226e545cef5 
q-agent-notifier-tunnel-update fanout 5d5ald6ecf16449390c7ca36dc6efa51 
13 agent 
compute.control 
conductor fanout_4ab247259a564434a5e032352f277d7c 
q-agent-notifier-tunnel-delete 
q-agent-notifier-port-delete.control 
q-agent-notifier-dvr-update fanout 92b4ac0aa88e4265a1b949ccd6313892 
notifications.info 
q-agent-notifier-port-update fanout 11b3b15fa6554efdb0a218022a80435f 
q-agent-notifier-network-update 
q-server-resource-versions fanout 99933489d6784097ad4058803c88c56e 
q-reports-plugin fanout 1152f2bc68844d10ale4dbffb477f1e3 

13 agent.control 
q-agent-notifier-dvr-update.control 

q-plugin fanout ff9d2fe4070648d186ba909dfe7a9d86 














































































































































































































network.control 
reply 29eabc9e9dfa496d9clea4cf80fd4qd70 

13 agent _fanout_e34ff693a97543bb96£24284782ab925 

cinder-volume 

q-server-resource-versions 
q-agent-notifier-security group-update fanout 5cbfe827cfb1463db1de80f71980bf6b 
compute fanout d7e8f4261c844ea7b09f556887a668f6c 



















































































reply f55a4a857dal443c80423fe9bb707a47 

q-reports-plugin fanout 64e60132629d8499a8f8ea6c88a0c63ad 
q-13-plugin.control 
q-13-plugin fanout 510f2af4df054d0b9ee0e5893744e0cb 
q-agent-notifier-network-update fanout b01c7a625c8e46708514899e6068ce807 
consoleauth.control 
q-agent-notifier-port-delete fanout a7405262094e42f69bbdf4f876f2d0f2 
q-agent-notifier-port-delete 

reply 41f7f558bb44490da48fd4ec12fa8e00 

dhcp agent.control 

q-13-plugin fanout 3cfda731074946ca8bff14632e802932 

cinder-scheduler 

consoleauth 

network 
dhcp agent 
q-agent-notifier-tunnel-update.control 
q-reports-plugin 
consoleauth fanout 65a9a041c23b41565084488805acd689f6 
scheduler.control | 
q-agent-notifier-network-update.control 

Scheduler 
cinder-scheduler.control 
scheduler fanout f023f2ff8d6f447da88bfd039d945a24 
reply 2786ca621e6345d4b79145709c4bd549 

cinder-volume fanout 6f81cbd91fd64169bb8256253eb476cf 
q-server-resource-versions.control 

conductor fanout d6lebbded83a47ef8cd09fbbfb9d4a72 
q-agent-notifier-security group-update 
q-agent-notifier-tunnel-delete.control 

compute 
dhcp agent fanout e97e852033884789a936eca"7flbc02c2 
q-agent-notifier-tunnel-update 

reply 1653ecdea94d471dbbc2d43a53c8508a 
q-plugin.control 

q-agent-notifier-dvr-update 
q-agent-notifier-security group-update.control 
q-agent-notifier-port-update.control 
q-agent-notifier-port-update 

q-13-plugin 
cinder-volume.control8lvmdriver-1 
q-reports-plugin.control 


















































































































































































































































































































































oon 


其 他 相关 的 RabbitMQ 命 令 ， 可 以 输入 如 下 命令 查询 : 





rabbitmqctl --help 





10.5 FRASER 


在 上 面 分 析 的 基础 先 来 做 一 次 修改 实践 ， 以 修改 Nova 操 作 权限 判断 流程 为 例 。 
1. 找 到 需要 查看 的 内 容 
Nova 创 建 虚拟 机 时 ， 会 调用 nova/compute/api.py 中 API 类 的 _check_create_policies 方 法 并 根据 policy.json 文 件 内 容 进 行 操作 权限 的 判断 ， 如 图 10-21 所 示 。 


mE on compute 

: B E monitors 
[+}- resources 
T = : . F A i E ^ 
Lo. F- : g action = ' As: Xs' % (scope, action) 


(def check policy (context, action, target, scope> compute ): 





[=| ite (cme context, action, target) 
图 10-21 policy. #4 


该 方法 最 终 会 调用 nova/policy.py 中 的 enforce 方 法 ， 代 码 如 下 : 

















def enforce(context, action, target, do raise-True, exc-None): 





init () 

credentials = context.to dict () 

if not exc: 
exc = exception.PolicyNotAuthorized 





























try: 
result = ENFORCER.enforce(action, target, credentials, 
do raise-do raise, exc-exc, action-action) 
except Exception: 





credentials.pop('auth token', None) 
with excutils.save and reraise exception(): 
LOG.debug('Policy check for $(action)s failed with credentials ' 
'S(credentials)s', 
('action': action, 'credentials': credentials]) 
return result 




















2. 添 加 代码 


如 果 想 知道 程序 运行 到 此 时 ，credentials 中 有 什么 内 容 ， 那 么 我 们 可 以 按 如 下 方式 修改 文件 注意 对 比 上 面 代 码 ， 新 增 的 3 行 代 码 如 下 : 





LOG.debug ('*'*200) 
LOG.debug (credentials) 
LOG. debug ('*'*200) 


加 入 行 号 的 代码 如 图 10-22 所 示 。 


95 Init) 

96 credentials = context.to_dict() 
97 

96 LOG. debug(' *'*200) 

99 LOG. debuoc[£s TOR ERES. 
100 LOG.debug( '* '* 20W) 

101 

102 1 十 not exc: 

103 exc = exception.PolicyNotAuthorized 


图 10-22 ”添加 debug 信 息 






Qi 
可 以 参考 源 代码 中 包含 LOG.debug 的 使 用 ， 显 示 行 号 的 vi 操作 为 底 行 模式 。 


:Set number 





3. 编 译文 件 


文件 修改 完 后 ， 必 须 经 过 重新 编译 才能 看 到 效果 ， 把 原来 的 policy.pyc 删 除 ， 重 新 启动 APl， 重 新 编译 修改 的 文件 。 





# rm policy.pyc 
rm: remove regular file 'policy.pyc'? y 











需要 重新 启动 nova-api 服 务 ， 如 图 10-23 所 示 。 


[stackücontrol devstack]$ /usr/bin/nova-api & echo $! »/opt/stack/status/stack/n-api.pid; fg || echo "n-api failed to start" | tee "/op 
t/stack/status/stack/n-api.failure" 
6$(L) n-api* 7$(L) q-svc 8$(L) q-agt 9$(L) q-dhcp 10$(L) q-13 11$(L) q-meta 12$(L) n-cond 13$(L) n-sch 14$(L) n-novnc 15$(L) 


图 10-23 nova-api 启 动 命 今 


oon 


通过 scteen 找 到 hova-api， 然 后 按 Ctd+C 组 合 键 强制 终止 ， 再 手动 重启 。 重 局 后 会 生成 新 的 policy.pyc 文 件 如 图 10-24 所 示 。 


[root@control noval# ls -alt 

total 960 

drwxrwxr-x 34 stack stack 4096 Oct 12 05:03 . 

-rw-rw-r-- 1 stack stack 9029 Oct 12 05:03 policy.pyc 
-rw-r--r-- 1 stack stack 16364 Oct 1? 04:58 .policy.py.swp 
-rw-rw-r-- 1 stack stack 4853 Oct 12 04:49 policy.py 


图 10-24 policy.pyc 文 件 
4.API 的 输出 


在 页 面 上 进行 操作 后 ， 就 会 在 API 的 终端 输出 ， 如 图 10-25 所 示 。 


2016-10-12 05:08:40.294 DEBUG nova.policy [req-cbb6c540-d38f-4aea-b/90-657/15f9e3dbc demo invisible to admin] "*"***»J»«(A x y y | y eee 
vt ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve de ve ve ve ve ve ve ve ve ve ve ve ve ve de ve ve ve ve ve ve ve ve ve ve ve ve ve de ve ve ve ve ve de ve ve ve de ve ve ve ve ve ve ve ve ve ve ve de ve ve ve de ve de ve de ve de ve ve ve ve ve de ve ve ve de ve ve ve ve ve ve e de e ve ve de ve ve de e ve ye ye ye ye ye ex 
ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve ve vk ve oe oe ve ve e ve ye e xx from (pid= 52887) enforce /opt/stack/nova/nova/policy. py: 98 
2016-10-12 05:08:40.295 DEBU | 4 [req-cbb6c540- -d38f -4aea-b/90- 65715f9e3dbc demo invisible to admin] a domain’ None, ‘proje 
name’: u'invisible to admin', ‘project_ dain None, 'timestamp': '2016-10- 11721: 08:40. 2/7988", ,auth- token' 'f8575ecceb4317299b2d022 
c2042f1/1', 'remote address': '10.20.0.50', 'quota class': None, ‘resource .uuid': None, ‘is _admjn' False, ‘user’: u'80cl2bala57049ac96 
cc282fb9360a2c', 'service catalog': [íu'endpoints': [íu'adminURL ': u'http://10. 20. 0.50: 87767v2/4Safala60cBa427e944057 86abb661dó' , u'reg 
ion': u'RegionOne', u'internalURL ': u http: //10. 20. 0. 50: 8770/v2/45afala60c8a427e944057 BGabbGG1d6. u ,PublicURL': u ‘http: //10.20. 0.50:87 
76/v2/45afala60c8a42/7e94405786abb661d6'})], u 'type' u "volumev2' ; U ‘name u'cinderv2' P, {u' endpoints': [{u' adminURL': u 'http://10.20.0. 
50: 8776/v1/45afala60c8a427e94405786abb661d6' u reg jon': u'RegionOne', u "internalURL': u ‘http: //10. 20.0. 50: 8776/v1/45afala60c8a427e9440 
5/86abb661d6', u'publicURL': u'http://10.20. 0. 50: 8776/vi/45afalao0c8a427e944057 86abb661d6 1], u'type': u'volume', u'name': u'cinder'1], 
'tenant': u'ÀSafala60c8a427e94405/86abb661d6' , 'read only': False, 'project id': u 'A5afala60c8a42/e94405786abb661d6' , 'user id': u'80c 
12bala5/049ac96cc282fb9360a2c', 'show deleted': False, 'roles': [u Member'], 'user. identity': '80cl2bala5/049ac96cc282fb9360a2c 45afala 
60c8a42/e94405/86abb661d6 - 一 = i "read -deleted' 'no', 'request id' req-cbbó6c540-d38f-4aea-b/90-65715f9e3dbc', 'instance lock checke 
d': False, 'user domain': None, 'user name': u ' demo ' i from (pid- 52887) enforce CUBES ea op rg gh A py: 99' 
2016-10-12 05:08:40.297 DEBUG nova. policy [req-chb6c540- -d38f-4aea-b/90-65/15f9e3dbc demo invisible to admin] "***J*»J3 x de e e sle k y d ee 


vt ve ve ve ve ve ve ve ve ve ve e ve ve ve ve ve ve ve ok ve ve ve e ve ve ve e de de fe e de de ve ve e de ve ve e de ve ve ve ve ve ve ve ve e ve ve ve e e ve ve ve de ve ve ve de ve ve ve e de ve ve e de de ve ve e de ve ve ve de e ve ve de de ve ve de de ve ve ve ve ve ve ve ve de ve ve fe ve ve ve ve ve ve ve ve e de de fe ve de de ve ve ye de ve ve ye de ve ve ve de e ve ye ex 
Joey KKK KAKA Ke Kee Kee KeAKEKE From (51d-52887) enforce /opt/stack/noeva/neva/policy.py: 100 





图 10-25 ”终端 输出 logo 信 息 


er 


可 以 使 用 这 种 方法 来 验证 前 面 章节 的 代码 分 析 ， 虽 然 Nova 代 码 比 较 复 杂 ， 但 是 其 框架 还 是 比较 容易 掌握 的 ， 可 以 根据 需求 和 业务 需要 找到 要 修改 的 地 方 。 


10.6 API V2.1 襄 明 


Nova 的 API 已 经 正式 切换 到 了 V2.1 版 本 。V2.1 版 本 和 之 前 的 V2 版 本 的 不 同 点 主要 体现 在 以 下 几 方 面 : 


1) 采用 JSON schema 对 输入 参数 的 合法 性 和 完整 性 进行 校 验 。 
2) 引入 Microversion 的 概念 ， 即 在 每 次 对 API 做 出 对 接口 有 影响 的 修改 后 ， 都 要 更 新 相应 的 Microversion 版 本 ， 如 图 10-26 所 示 。 


[rootücontrol devstack]# nova version-list 
Client supported API versions: 

Minimum version 2.1 

Maximum version 2.225 


Server supported | API versions: 


ELE d———————7— 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 + 
| Id | Status | Updated | Min Version | Version | 
十 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 + 


| v2.0 | SUPPORTED | 2011- 0l- 21711: 33: 21z | | | 
| v2.1 | CURRENT | 2013- ur- Pape 33: ¿lz | 2-1 | 2-293 | 


图 10-26 Nova API 的 Mictovetsion 版 本 


Nova V2.1 和 V2.0 的 关系 如 下 : Nova V2.1API=V2compatibility+Validition +Microversioning. 


10.6.1 compatibility 


V2 的 endpoint 是 /V2，V2.1 的 endpoint 是 /V2.1，Mitaka 默 认 使 用 /V2.1， 但 也 可 以 使 用 /V2， 对 V2 兼 容 . 


允许 通过 request header (X-OpenStack-Nova-API-Version: 2.114) 指定 API 版 本 。response 中 会 带 有 版 本 信息 : 











GET / 

{ 

"versions": [ 

{ 
eg EP D 
links": [ 
{ 

"href": "http://localhost:8774/v2/", 
rel" self" 





, 
"status": "CURRENT", 
"version": "5.2" 
"min version": "2.1" 





] 
} 


10.6.2 Validation 


V2 版 本 的 API 对 没 定义 的 输入 参数 没有 验证 ; 向 客户 端 返回 的 HTTP500 响 应 没有 包括 错误 的 原因 。V2.1 增 加 了 /nova/apiopenstack/compute/schemas 验 证 请 求 对 象 的 API 版 本 。 


Qapi version(min version-'2.1', max version-'2.9') 





10.6.3 Microversion 

Microversion 是 Nova 在 Liberty 版 本 引入 的 一 个 概念 。 在 当前 版 本 中 ， 修 改 或 者 新 增 一 个 API 时 ， 需 要 指明 其 所 对 应 的 Microversion 版 本 。 在 调用 REST API 的 时 候 ， 通 过 在 头 中 加 入 新 的 字段 “X 
Openstack-Nova-API-Version” 指 定 相应 的 Microversion 版 本 来 访问 特定 的 版 本 的 APl。 

Microversion 格 式 采 用 X.Y 的 格式 ， 其 中 X 只 有 在 发 生 大 的 导致 API 不 能 向 前 兼容 的 变动 时 才 会 变更 ， 而 Y 则 是 这 里 所 提 到 的 Microversion 当 前 已 经 更 新 到 了 2.13 版 本 。 


在 使 用 Microversion 的 同时 ， 还 需要 在 nova/api/openstack/api_version_request.py 文 件 中 指定 min_version 以 及 max_version， 即 当前 所 支持 的 最 低 版 本 以 及 最 高 版 本 ， 一 般 最 低 版 本 是 V2.1， 而 最 
高 版 本 是 刚刚 修改 过 的 版 本 。 只 有 当 发 生 了 很 大 的 改动 导致 不 能 向 前 兼容 的 时 候 才 需要 修改 最 低 版 本 。 


Openstack 为 整个 Microversion 所 使 用 的 新 增加 的 头 (Head) 指定 了 命名 规则 ， 如 果 需 要 引入 Mircoversion， 名 称 均 采用 如 下 格式 : 





X-OpenStack-[SERVICE TYPE]-API-Version: 2.114 




















例如 ，keystone 采 用 Mircoversion 后 会 加 入 如 下 头 : 


X-OpenStack-Identity-API-Version: 2.114 











Nova 是 Openstack 中 一 贯 的 先行 者 ， 其 在 标准 出 台 前 就 已 经 发 布 了 带 有 Microversion 的 API 版 本 ， 采 用 的 头 是 X-Openstack-Nova-API-Version， 但 为 了 保证 前 向 兼容 性 ， 仍 然 会 保持 这 样 的 命名 方 
式 。Nova 的 头 显示 结果 如 图 10-27 所 示 。 








i @ WizTools.org RESTClient 3.5 
File Edit History Tools Help 





= i 


Header 
MAuthToken O» £(469bb73e91bfd4e997 cfed82d1973f3 


ui pM TEM LE 
aa TALI TN SEIEN i E: F ea EN Ko ee oiik. Puin »* TX Ji. ee e 


Content-Type iapplication/jsan 





HTTP Response 
Status: HTTP/1.1 200 OK 


Test Result 


HTTP Header 
Content-Length 
Ca ntent-Type appicaonjson — ăć ë  ăć 


X-Openstack-Nova-Api- Version 
Ad TERETE EUN RE n-versian Hiire 本本 | - J) | 


Vay — —  -OpenStac-Nova-APHVersion — 


A-L'ompute-Request-ld req-120c32982a-d1/3-43e1-aBeU-Scabeb... 
Dae —— Mue 110d2016 224337 GMT 





l 


1 WizTools.ora RESTClient 


图 10-27 Nova 的 头 显 示 结 果 
Qs 
Itonic 也 是 类 似 的 情况 。 


在 实际 的 使 用 过 程 中 ， 当 不 包含 此 头 的 时 候 ，API 会 默认 指向 最 低 版 本 。 当 此 头 存 在 且 指 定 了 某 一 个 版 本 时 ，API 会 响应 相对 应 的 版 本 ， 当 指定 的 版 本 不 存在 时 ， 会 返回 HTTP406 错 误 ， 并 且 返 回 当前 所 
支持 的 最 高 和 最 低 Microversion 版 本 范围 。 当 包含 此 头 且 使 用 关键 字 “latest” 作 为 版 本 号 时 ， 会 指向 当前 的 最 大 版 本 号 。 


当 使 用 Microversion 头 时 ， 返 回 值 内 容 中 也 会 相应 地 增加 : 


表示 当前 执行 了 的 Microversion 版 本 号 : 























X-OpenStack-[SERVICE TYPE]-API-Version: version number 





表示 当前 所 能 支持 的 最 小 版 本 号 : 























X-Openstack-[SERVICE TYPE]-API-Minimum-Version: min version number 








表示 当前 所 能 支持 的 最 大 版 本 号 : 























X-Openstack-[SERVICE TYPE]-API-Maximum-Version: max version number 


nova-pythonclient 目 前 不 支持 microversioning， 需 要 更 新 代码 支持 X-OpenStack-Nova-APl-Version 参 数 。 


10.7 编码 


本 章 提供 了 示例 代码 供 读者 参考 。 


10.7.1 示例 编码 


在 spec 被 3pprove 之 后 ， 就 进入 到 具体 编码 的 环节 了 ， 在 编码 过 程 中 除了 对 功能 进行 实现 外 ， 最 重要 的 是 进行 Microversion 的 相关 操作 。 


首先 ， 当 需要 增加 一 个 全 新 的 方法 时 ， 最 好 采用 装饰 器 的 方法 ， 例 如 : 


[python] view plain copy 
Qwsgi.Controller.api version("2.4") 
def my api method(self, req, id): 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path-/openresources/teac 






































这 表示 从 2.4 开 始 才 会 调用 此 方法 ，@wsgi.Controller.api version ("2.4") 装饰 器 就 是 对 req 对 象 中 的 api_version_redquest 对 象 (f£ ABSX-Openstack-Nova-API-Version) 进行 识别 ， 从 而 区 分 不 同 


的 代码 逻辑 。 


^ 


如 果 要 对 现 有 的 代码 逻辑 做 出 一 定 的 更 改 ， 则 一 般 会 采用 如 下 方法 : 


[python] view plain copy 
üwsgr.Controller.api version("2.1", "2.3") 
def my api method(self, req, id): 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path-/openresources/teac 






































Qwsgi.Controller.api version("2.4") # noqa 
def my api method(self, req, id): 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path-/openresources/teac 






































显而易见 ， 当 Microversion 版 本 号 在 2.1 ~ 2.3 之 间 时 会 调用 method_1; 而 当 版 本 号 大 于 等 于 2.4 时 则 会 调用 method_2。 需 要 注意 的 是 ， 采 用 这 种 方法 时 需要 在 靠 后 的 方法 定义 后 面 添加 #noqa 关 键 


避免 pep8 错 误 。 


当 改 动 较 小 时 ， 则 可 以 只 将 相应 的 逻辑 提出 来 做 版 本 处 理 : 


[python] view plain copy 
Qapi version("2.1", "2.4") 
def version specific func(self, req, argl): 















































pass 

Qapi version(min version-"2.5") # noqa 

def version specific func(self, req, argl): 
pass 








def show(self, req, id): 

ttp: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/. .http://www.hzcourse.com/resource/readBook?path=/openresources/teac 
self. version specific func(req, "foo") 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path-/openresources/teac 











x 




















































































































当 改 动 只 有 一 两 行 时 ， 则 建议 采用 直接 在 原 逻 辑 中 增加 判断 逻辑 的 方法 : 


[python] view plain copy 
def index(self, reg): 
«common code» 














req version = req.api version request 

if req version.matches("2.1", "2.5"): 

http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/..http: //www.hzcourse.com/resource/readBook?path-/openresources/ 
elif req version.matches("2.6", "2.10"): 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path-/openresources/ 
elif req version » api version request.APIVersionRequest ("2.10"): 
http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/..http://www.hzcourse.com/resource/readBook?path-/openresources/ 


















































































































































«common code» 


在 实现 完 功能 后 ， 需 要 添加 合适 的 测试 用 例 ， 才 能 算是 修补 完成 。 由 于 修改 了 API 接口 ， 会 对 functional test 造 成 一 定 的 影响 ， 要 相应 修改 functional test, —fgxjfunctional test 的 修改 是 为 新 增加 的 


版 本 增加 相应 的 API 输 入 /输出 示例 文件 ， 并 将 其 放 入 相应 的 位 置 。 


10.7.2 ”官方 代码 参考 


Nova API V2.1 版 本 已 经 弃 用 原来 的 Nova 扩 展 方 法 ，Nova 源 码 中 的 compute/contrib 目 录 已 经 没有 ， 如 图 10-28 所 示 。 


[- openstac 





m muENMISMISSENSNESNNSINSINESSNESNSNESNSSNSIESNSFNSNIERE: 








图 10-28 不 再 支持 Nova 扩 展 


通过 简短 的 原型 代码 更 容易 理解 Nova REST API MicroversionsB RBE R. 


1.api version.py 


api_version.py 是 API 版 本 的 示例 : 





class InvalidVersionString (Exception): 





pass 











This class represents an API 


class APIVersion (object): 








methods for manipulation and comparison of version 








Version with convenience 


numbers that we need to do to implement microversions. 


= 


def init (sel 


, version string-None): 








Create an API version object. 





self.ver major - None 
self.ver minor = None 

















if version string: 


ver array = version string.split('.') 











raise 


if len(ver array) 





l= 2: 





try: 


InvalidVersionString () 


= inl 





self.ver major 








(ver array[0]) 
] 





= int 





self.ver minor 
except ValueError: 


raise 








(ver array[1]) 


InvalidVersionString () 





def str (self): 
"""String representation just 








return "Major: $s, Minor: $s" $ (sel 





def is null (self): 


€ 


return sel 


.ver major is None and sel 





for debugging purposes""" 


[o E 


.ver major, 


self.ver minor) 


























def  cmp (self, 


other): 


























f.ver minor is None 








if self.ver major « other.ver major: 
return -1 v 
elif self.ver major == other.ver major: 
if self.ver minor « other.ver minor: 
return -1 i 
elif self.ver minor -- other.ver minor: 
return 0 
return 1 





def matches(self, min version, max version): 








Returns whether the version object represents a version 
greater than or equal to the minimum version and less than 
the maximum version. 


Gparam min version: Minimum acceptable version. 











Gparam max version: Maximum acceptable version. 
@returns: boolean 


f min version is null 














If max version is null 














if max version.is null 
return True 
elif max version.is nul 

















return min version 
elif min version.is nul 

















else: 





return self »- max 














2.versioned function.py 


versioned function.py 是 存储 版 本 信息 的 方法 : 


then there is no minimum limit. 
then there is no maximum limit. 
() and min version.is null(): 
l0: 
<= self 
0: 
. version 
return min version «- self «- max version 
func): 


def | init (self, name, start version, end version, 


Versioning int 


Formation 





for a single function 





@name: Name of 





F the method 


@start version: Minimum acceptable version 





Gend version: Maximum acceptable version 


@func: Method 





to call 


Minimum and maximums are inclusive 





self.name = name 





self.start version = start version 
self.end version = end version 
self.func = func 
































def str (self 


"o 


return $58: 


s ss" $ (self.name, self.start version, self.end version) 











$ 














3.versioned object.py 


versioned_object.py 是 版 本 方法 的 基 类 对 象 : 


class VersionedFunction (object): 
import six 





import api version 
from versioned function import VersionedFunction 














class VersionedObject (object): 
"""Base class for classes that support versioning of their methods.""" 



































def  getattribute (self, key): 





def version select(*args, **kwargs): 











Look for the method which matches the name supplied and version 
constraints and calls it with the supplied arguments. 








@return: Returns the result of the method called 
Qraises: AttributeError if there is no method which matches the 
name and version constraints 
































# First arg to the method is the version. In the real API 
# code this is always the request object and we will put 
# the version object as an attribute of the request object 
ver — args[0] 


























func list = self.versioned functions [key] 
For func in func list: 
if ver.matches(func.start version, func.end version): 


return func.func(self, *args, **kwargs) 












































# No version match 
raise AttributeError 














if key in object. getattribute (self, 'versioned functions'): 
return version select 
else: 
return object. getattribute (self, key) 


























# No method name match 
raise AttributeError 








@classmethod 
def api version(cls, min ver, max ver=None) : 














Decorator for versioning methods. 


Add the decorator to any method which takes a version object 
as the first parameter. Note in the Nova API it would be any 
method which takes a request object as the first parameter and 
the version object would be attached to the request object. 




















For example: 

Qapi version("1.0.0") 

def my method(ver, paraml, param2): 
pass 








Qapi version("2.0.0") 
def my method(ver, paraml, param2): 
pass 








An optional maximum version can also be supplied: 





Qapi version("3,0,0", "3.2.0") 
def my method(ver, paraml, param2): 
pass 














def decorator (f): 
obj min ver = api version.APIVersion(min ver) 
if max ver: a 

obj max ver = api version.APIVersion (max ver) 

else: 
obj max ver = api version.APIVersion() 


— 
































# Add to list of versioned functions registered 
func name = f. name _ 
new func = VersionedFunction( 

func name, obj min ver, obj max ver, 

















Fh 
— 











print new func 











func dict = getattr (cls, 'versioned functions”, {}) 
if not func dict: 


setattr(cls, 'versioned functions', func dict) 
























































func list = func dict.get(func name, []) 
if not func list: 
func dict[func name] - func list 























func list.append(new func) 

# Ensure the list is sorted by minimum version (reversed) 
# so later when we work through the list in order we find 
# the method which has the (latest version which supports 
# the version requested. Won't be an issue if we guarantee 
# no overlapping version definitions though 

func list.sort (reverse-True) 












































# TODO: Check there is no overlap in versions supported 
# which would make the request ambiguous 








return f 


return decorator 


4.test object.py 


test object.py 使 用 Microversions 装 饰 示例 : 


import versioned objec 
from api version import 








CE €T 





APIVersion 








class TestObject (versioned object.VersionedObject) : 








# Example of versioning on a method that will be called 
# externally 
@versioned object.VersionedObject.api version("1.2") 
def add(self, ver, first, second): 

ud add" 





























# Broken version of add 
first = int(first) 

second = int (second) 

return first + second + 100 























@versioned object.VersionedObject.api version ("2.0") 
def add(self, ver, first, second): 

# fixed version of add 
first = int(first) 
second = int (second) 
return first + second 















































# Example of versioning on a method that will be called 
# from within the class but still passed the version 
4 
@ 














information 
versioned object.VersionedObject.api version ("1.0") 
def real sub(self, ver, first, second): 

return first - second 


























Gversioned object.VersionedObject.api version("2.0") 
def real sub(self, ver, first, second): 
return second - first 


























def sub(self, ver, first, second): 























first = int(first) 
second = int (second) 
return self. real sub(ver, first, second) 








def multiply(self, ver, first, second): 
First = int (first) 
second = int (second) 




















# Example of inline version matching 

if ver.matches (APIVersion("1.1"), 
APIVersion("2.1")): 

return first * second 

else: 
return first / second 



































5.test versioned object.py 
test versioned object.py 用 于 测试 对 象 类 : 


#! /usr/bin/python 


from test object impor 
from api version import 


TestObject 
APIVersion 








CT CT 








myobj = TestObject () 

ver = APIVersion("1.2") 
ver2 = APIVersion("2.2") 
ver3 = APIVersion("1.0") 

















print "Finished init" 























print myobj.add(ver, 1, 2) # Expect broken add result 
print myobj.add(ver2, 1, 2) # Expect fixed add result 
try: 





print myobj.add(ver3, 1, 2) # Expect no match to a method to be made 
except AttributeError: 
print "Got attribute error as expected" 















































print myobj.sub(ver3, 4, 8) 4 Expect normal sub result 
print myobj.sub(ver2, 4, 8) # Expect weird sub result 
print myobj.multiply(ver, 8, 4) # Expect normal multiply 
print myobj.multiply(ver2, 8, 4) # Expect divide 

print myobj.multiply(ver3, 8, 4) # Expect divide 




















10.7.3 ”Nova 代 码 实 现 示例 


1) 修改 setup.cfg 文 件 。 进 入 /opt/stack/nova， 编辑 setup.cfg 文 件 ， 在 nova.api.v21.extensions= 后 面 按照 格式 添加 如 下 一 行 : 





test = nova.api.openstack.compute.test:Test 


2) 创建 test.py 文 件 。 进 入 如 下 目录 : 


/opt/stack/nova/nova/api/openstack/compute 

















































































































创建 test.py 文 件 : 

# Copyright 2013 OpenStack Foundation 

# 

# Licensed under the Apache License, Version 2.0 (the "License"); you may 
# not use this file except in compliance with the License. You may obtain 
# a copy of the License at 

# 

# http://www.apache.org/licenses/LICENSE-2.0 

# 

# Unless required by applicable law or agreed to in writing, software 

# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT 
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the 
# License for the specific language governing permissions and limitations 
# under the License. 








from nova.api.openstack import extensions 
from nova.api.openstack import wsgi 











ALIAS = "os-test" 
authorize = extensions.os compute authorizer (ALIAS) 








class TestController (wsgi.Controller) : 














def init (self, *args, **kwargs): 
super(TestController, self). init (*args, **kwargs) 











def index(self, req): 
return {'index': 'list'} 

















def create(self, reg, body): 
return {'create': 'Success'} 























def update(self, reg, id, body): 
return {'update': id} 




















def delete(self, req, id): 
return {'delete': id} 


























def get test(self, req, body): 
return body 

















class Test (extensions.V21APIExtensionBase) : 








"""Nova Test Extension.""" 











name — "Test" 
alias = ALIAS 
version = 1 











def get resources (self): 
action = ('get test': 'POST'} 











res — extensions.ResourceExtension (ALIAS, 
TestController(), 
collection actions-action 
) 

















return [res] 














def get controller extensions (self): 
turn [] 


3) 重启 nova-api 服 务 。 


4) 测试 结果 。 执 行 如 下 命令 : 














nova list-extensions | grep test 


结果 如 图 10-29 所 示 ， 显 示 test 这 个 服务 已 经 被 添加 了 进来 。 


[root@packstack ~(admin)]# nova List-extensions | grep test 





| Test | Nova Test Extension. | 2014-12-03T00:00:007 | 


图 10-29 Nova 扩展 结果 显示 


执行 如 下 命令 : 














openstack token issue 


命令 执行 结果 如 图 10-30 所 示 。 


expires 201/-02-13108:09:51^7 

id 6294e64630d543T /6b0399T1TB0527a0d 
project id | 4492/fedSbOb465e0b35153a58 /b3806f5ce 
user id b94/900/29654fTbh18e/el10c062al303a 





图 10-30 ”获取 token 
test.py 中 的 方法 测试 有 以 下 几 种 。 
(1) index 对 应 GET 方 法 


获取 token 后 执行 如 下 命令 : 

















curl -g -i -X GET http://192.168.138.12:8774/v2/4492']£ed950b46e0b3£8a358 703061 




















f5ce/os-test -H "User-Agent: python-novac lient" -H "Accept: application/json" -H "X-Auth-Token: 825 


命令 执行 结果 如 图 10-31 所 示 。 


HITP/1.1 260 OK 

Content-Length: 1/ 

Content-Type: application/json 

X-Compute-Reguest-Id: reg-f/9410fd-32f6-4d05-8a6d-5ao2feldcóoec 
Date: Mon, 13 Feb 2017 07:10:21 GMT 





on i | 


['index": “List” EK eine eieae: a BE 


10-31 ”测试 index 
(2) create 对 应 POST 方法 
执行 如 下 命令 : 


curl -i -g -X POST http://192.168.138.12:8774/v2/44927fed9b0b46e0b3f8a587b306f5ce/os-test -H "User-Agent: python-novaclient" -H "Content-Type: application/json" -H "X-Auth-Tok 





























命令 执行 结果 如 图 10-32 所 示 。 


HIIP/1.1 200 OK 

Content-Length: 21 

Content-Type: application/json 

X-Compute-Request-Id: req-d5253a20-1450-433f -9abd- /d0/0/092d89 


Date: Mon, 13 Feb 201/ 07:42:28 GMT 





["create": "Success"}[root@packstack -(admin)]£ J 
图 10-32 ”测试 create 
(3) update 对 应 PUT 方法 
执行 如 下 命令 : 


curl -g -i -X PUT http://192.168.138.12:8774/v2/44927fed9b0b4 6e0b3 £8a587b306f5ce/os-test/xxx -H "User-Agent: python-novaclient" -H "Content-Type: application/json" -H "X-Auth- 





























命令 执行 结果 如 图 10-33 所 示 。 


HTTP/1.1 200 OK 

Content-Length: 1/ 

Content-Type: application/json 

X-Compute-Request-Id: req-1/623080-0Tb4-482d-938d-4/708df22d353 
Date: Mon, 13 Feb 2017 07:41:06 GMT 


["update": "xxx"}[root@packstack -(admin)]£ B 





图 10-33 ”测试 update 


(4) delete 对 应 DELETE 方 法 


执行 如 下 命令 : 






































curl -i -g -X DELETE http://192.168.138.12:8774/v2/44927fed9b0b4 6e0b3£8a587b306f5ce/os-test/xxx -H "User-Agent: python-novaclient" -H "Content-Type: application/json" -H "X-Au 








命令 执行 结果 如 图 10-34 所 示 。 


HTTP/1.1 200 OK 

Content-Length: 1/ 

Content-Type: application/json 

X-Compute-Reguest-Id: req-6ac4c193-114/7-42d4-64/74-e8cb?60c /a55 
Date: Mon, 13 Feb 2017 07:41:53 GMT 


["delete": "xxx"}[root@packstack ~(admin) ]# J 





图 10-34 ”测试 delete 


这 些 方法 是 自动 对 应 的 。 其 中 create 方 法 的 body 是 必需 的 ;update 方法 的 id 和 body 是 必需 的 ，id 在 请 求 URL 的 尾部 传 入 ; delete 方 法 的 id 是 必需 的 ，id 在 请 求 URL 的 尾部 传 入 ， 传 入 body 的 请 求 必须 加 
-E-H'Content-Type: application/json"，body 必 须 为 JSJON 类 型 。 


AA, get test 方法 属于 扩展 的 方法 ， 需 要 人 在 Test 类 中 单独 注 明 ， 例 如 : action={'get_test': "POST )}。 


请 求 格式 如 下 : 


























curl -g -i -X POST nttp://192.168.138.12:8774/v2/44927fed9b0b46e0b3f8a587b306f5ce/os-test/get test -H "User-Agent: python-novaclient" -H "Content-Type: application/json" -H "X 











命令 执行 结果 如 图 10-35 所 示 。 


HIIP/1.1 208 OK 
Content-Length 
Content-Type: 


A-Compute-Request-Id: 
Date: 


J I! t est" 


10.8 调试 并 修复 nova-compute 的 所 有 协 程 
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16 


application/json 
6b /b9191-1a60- 


Feb 


re 


q- 


2017 07:19:24 


"test" Madu ln 


案例 ， 发 生 在 测 计算 





























卡 住 的 


GMT 


437a-a999-1095a4a4/5/9 


-(admin) |# 


图 10-35 ”扩展 test 方 法 


问题 








节点 高 可 用 时 ， 当 关 掉 一 台 节 点 后 ， 一 旦 触发 Nova host-evacuate， 所 有 的 nova-compute 都 从 消息 队列 上 掉 线 。 






































































































































































































































































































































调查 发 现 nova-compute 的 整个 进程 卡 在 futex 锁 的 等 待 上 ，eventlet 不 再 做 协 程 切 换 。strace 的 输出 如 下 。 

1.strace-p nova 的 pid 输 出 

epoll wait(12, {}, 1023, 0) = 0 

epoll wait(12, {}, 1023, 0) = 0 

epoll wait(12, {}, 1023, 0) = 0 

epoll wait (12, {}, 1023, 0) = 0 

epoll wait(12, {{EPOLLIN, {u32=50, u64=9226080133993988146}}}, 1023, 8) =1 

http://www. hzcourse. com/resource/readBook?path-/op nresources/teach ebook/uncompressed/17414/OEBPS/Text/. 

epoll ct1(12, EPOLL CTL ADD, 50, (EPOLLIN|EPOLLPRI|EPOLLERR|EPOLLHUP, {u32=50, u64=9226080133993988146}}) = 0 

http: //www.hzcourse. -com/ resource/readBook?path-/op nresources/teach ebook/uncompressed/17414/OEBPS/Text 

mmap (NULL, 1052672, PROT READ|PROT WRITE, MAP PRIVATE|MAP ANONYMOUS|MAP STACK, -1, 0) = 0Ox7fde40342000 

mprotect (0x7£de40342000, 4096, PROT NONE) = 0. n E 

clone (child stack=0x7fde40441fb0, flags=CLONE VM CLONE FS|CLONE FILES|CLONE SIGHAND|CLONE THREAD|CLONE SYSVSEM|CLONE SETTLS|CLONE PARENT SETTID|CLONE CHILD CLEARTID, parent tic 
rft . Sigprocmask (S G SETMASK, [], NULL, 8) = 0 

futex(0x87a2200, FUTEX WAKE PRIVATE, 1) = 

futex(0x7ffdee035afc, FUTEX WAIT PRIVATE, 1, NULL «detached http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/0EBPS/Text/...» 
最 后 这 个 futex 的 等 待 锁 的 操作 一 直 不 返回 ， 导 致 Python 的 主线 程 得 不 到 调度 ，eventlet 协 程 就 不 再 调度 了 ， 因 此 nova-compute 彻 底 卡 住 。 


实验 的 过 程 中 ， 关 闭 的 物理 机 上 有 RabbitMQ 消 息 队 列 、ceph-monitor 等 服务 。 一 开始 怀疑 是 消息 队列 的 问题 ， 但 是 kombu 的 代码 是 纯 Python 实 现 ， 所 有 的 阻塞 调用 都 已 经 被 eventlet 给 


monkey patch 7, 
扩展 库 
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导致 的 。 
2. 安 装 Python 的 调试 符号 和 工具 链 
执行 如 下 命令 : 
yum install yum-utils 
debuginfo-install glibc 
yum install gdb python-debuginf 


然后 启动 gdb 并 附着 到 nova-compute 的 进程 上 。 


3. 附 着 到 nova-compute 


执行 如 下 命令 : 


gdb python 


oon 


19427 


19427 是 nova-compute 的 pid， 会 看 到 gdb 加 载 了 很 多 调试 符号 ， 
















































































































































































































































































然后 就 可 以 用 常 


见 的 gdb 命 令 来 调试 了 。 





































































































会 切 回 eventlet 的 事件 循环 。 因 此 推测 这 个 futex 是 一 些 用 .so 实现 的 Python 扩 展 库 导致 的 ， 如 Ceph 的 librbd 或 者 libvirt 的 客户 端 库 。 下 面 需 


要 看 这 个 futex 为 什么 会 卡 住 了 ， 以 及 是 哪个 
























































































































































































































































































































































4. 查 看 所 有 线程 

(gdo) info threads 
Id Target Id Frame 
37 Thread Ox7f5e7ad8c700 (LWP 19472) "nova-compute" 0x00007f5ea866a69d in poll () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach book/uncompresse 
36 Thread 0x7£5e7a58b700 (LWP 19473) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
35 Thread 0x7£5e79d8a700 (LWP 19474) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
34 Thread 0x7£5e79589700 (LWP 19475) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
33 Thread 0x7f£5e78488700 (LWP 19477) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
32 Thread Ox7f5e63fff700 (LWP 19480) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
31 Thread 0x7f5e637fe700 (LWP 19481) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
30 Thread Ox7f5e62ffd700 (LWP 19482) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
29 Thread 0x7f5e627fc700 (LWP 19483) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
28 Thread Ox7f5e61ffb700 (LWP 19484) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
27 Thread Ox7f5e617fa700 (LWP 19485) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
26 Thread Ox7f5e60ff9700 (LWP 19486) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
25 Thread Ox7f5e43fff700 (LWP 19487) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
24 Thread 0x7£5e437fe700 (LWP 19488) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
23 Thread Ox7f5e42ffd700 (LWP 19489) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
22 Thread 0x7f£5e427fc700 (LWP 19490) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
21 Thread Ox7f5e41ffb700 (LWP 19491) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
20 Thread Ox7f5e417fa700 (LWP 19492) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
19 Thread Ox7f5e40ff9700 (LWP 19493) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
18 Thread Ox7f5e23fff700 (LWP 19494) "nova-compute" sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
17 Thread 0x7f5e237fe700 (LWP 19495) "nova-comput " sem wait () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text 
16 Thread Ox7f5e22ffd700 (LWP 29663) "gmain" 0x00007f£5ea866a69d in poll () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414 
15 Thread Ox7f5de97fa700 (LWP 41197) "log" pthread ， cond wait@@GLIBC 2.3.2 () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/174 
14 Thread Ox7f5el2ffd700 (LWP 41202) "service" pthread _cond_timedwait@@GLIBC 

2.3.2 ()at http://www .hzcourse.com/resource/readBook?path-/openr sources/teach ebook/uncompressed/17414/OEBPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 64/pthread cond timedwait 
13 Thread Ox7f5ddb7fe700 (LWP 41203) "nova-compute" pthread cond timedwait 

@@GLIBC 2.3.2 ()at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/0EBPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 64/pthread cond t 


































































































































































































































































































































































































































































































64/pthread cond wai 


Book?path-/openresources/teach ebook/uncc 























| 64/pt 


| 64/pt 








thread cond wai 


thread cond wai 


64/pt 








hread cond wait 


hread cond wait 


to5:l6 








t.S:1€ 
七 .S:18 
t.S:1€ 
t.S:1€ 








hread_cond_timedwait 


BPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 64/pthread cond t 


12 Thread 0x7£5e21b08700 (LWP 41204) "ms dispatch" pthread cond wait@@GLIBC | 
2.3.2 ()at http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 64/pthread cond wait.S:1€ 
11 Thread 0x7£5e22309700 (LWP 41205) "ms local" pthread cond waitGQGLIBC 2.3.2 E n 
()at http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 64/pthread cond wait.S:185 
10 Thread 0x7f5e21307700 (LWP 41206) "ms reaper" pthread cond wait@@GLIBC 
2.3.2 (at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 | 
9 Thread 0x7£5e20b06700 (LWP 41207) "safe timer" pthread cond timedwait@@GLIBC 2.3.2 () at http://www.hzcourse.com/resource/readl 
8 Thread Ox7f5el3fff700 (LWP 41208) "fn anonymous" pthread | cond wait@@GLIBC 
2.3.2 ()at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 
7 Thread 0x7f5e99a47700 (LWP 41209) "ms pipe write" pthread cond wait@@GLIBC 
2.3.2 ()at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 
6 Thread 0x7f5e78138700 (LWP 41210) "ms pipe read" 0x00007f5ea866a69d in poll 
() at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/../sysdeps/unix/syscall-template.5:81 
5 Thread Ox7f5e137fe700 (LWP 41211) "safe timer" pthread cond waitQQGLIBC | 
2.3.2 ()at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/0EBPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 
4 Thread Ox7f5e127fc700 (LWP 41212) "fn anonymous" pthread cond wait@@GLIBC 
2.3.2 ()at http: //www.hzcourse. com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 | 
3 Thread Ox7f5ellffb700 (LWP 41213) "tp librbd" pthread cond timedwait@@GLIBC 
2.3.2 ()at http: //www.hzcourse. con/ resource/readBook?path- /openresources/teach ebook/uncompressed/17414/OEBPS/Text/../nptl/sysdeps/unix/sysv/linux/x86 
2 Thread 0x7f5e20305700 (LWP 41214) "ms pipe write" pthread cond timedwait 
@@GLIBC 2.3.2 ()at http://www.hzcourse. com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/0E 
uL Thread 0x7£5ea983c740 (LWP 19427) "nova-compute" pthread cond wait@@GLIBC 2.3.2 ()at http://www.hzcourse.com/resource/readi 


最 后 一 个 线程 ， 即 当前 线程 




















































































































( 带 星 号 ) 卡 在 pthread cond wait. EF, 
















































































































































































































































































































































































































































































































































































































































































Book?path-/openresources/teach ebook/uncompress 


























5 查看 调用 栈 
(gdo) bt 
#0 pthread cond wait@@GLIBC 2.3.2 () at http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/17414/OEBPS/Text/../nptl/sysdeps/unix/sysv/linux 
#1  0x00007f5e7fa80b5080 in C SaferCond::wait() () from /lib64/librbd.so.1 
#2 0x00007f5e7fa2333222 in librbd::ImageState«librbd::ImageCtx^: :cpen () () from /lib64/librbd.so.1 
#3  0x00007f5e7f9f7ca9 in rbd open read only () from /1ib64/1 ibrbd.so.1 
#4  0x00007f5e892c4c95 in  pyx pw 3rbd 5Image 1 init () from /usr/lib64/python2.7/site-packages/rbd.so 
$5  0x00007f5ea9304d6f in type call (type= «optimized out», args=(<rados.Ioctx at remote 0x55d3440>, 'b527ea7a-da48-4bbd-947d-8ef0546cf87b disk'), 
kwds-('read only': True, 'snapshot': None}) at /usr/src/debug/Python-2.7.5/ 
Objects/typeobject.c: 745 
#6  0x00007f5ea92af0b3 in PyObject Call (func=func@entry=<type at remote 0x7f5e894e4360», 
arg=arg@entry=(<rados.Ioctx at remote 0x55d3440>, 'b527ea7a-da48-4bbd-947d-8ef0546cf87b disk'), 
kw=kw@entry={'read only': True, 'snapshot': None}) at /usr/src/debug/Python-2.7.5/Objects/abstract.c:2529 
#7 0x00007£5ea934325c in do call (nk-«optimized out», na-2, pp stack- 
Ox7ffcb99c2270, func-«type at remote 0x7f5e894e4360») 
at /usr/src/debug/Python-2. 7.5/Python/ceval.c:4316 
#8 call function (oparg-«optimized out», pp stack=0x7ffcb99c2270) at /usr/src/debug/Python-2.7.5/Python/ceval.c:4121 
#9 PyEval EvalFrameEx ( 
F-fGentry-Frame 0x6d94ef0, for file /usr/lib/python2.7/site-packages/nova/virt/libvirt/storage/rbd utils.py, line 76, in init (self-«RBDVolumeProxy at remote 0x8dfbb90> 
$10 0x00007f5ea93470bd in PyEval EvalCodeEx (co-«optimized out», globals- 
«optimized out», locals=locals@entry=0x0, args=args@entry=0x92d8a68, 
argcount-3, kws=kws@entry=0x8e25820, kwcount=kwcount@entry=3, defs-defsGentry-0x6ad7ec8, defcount=defcount@entry=3, closure=0x0) 
at /usr/src/debug/Python- Dal 5/Python/ceval. c:3330 
#11  0x00007f5ea92d405d in function ca (func=<function at remote 0x6ae8410», 
arg=(<RBDVolumeProxy at remote Ox8dfbb90», «RBDDriver (ceph conf-'/etc/ceph/ceph.conf', rbd user-'nova', pool='vms') at remote 0x37cd590>, 'b527ea7a-da48-4bbd-947d-8ef0546cf 
#12  0x00007f5ea92af0b3 in PyObject Call (func=func@entry=<function at remote 0x6ae8410>, 
arg=arg@entry=(<RBDVolumeProxy at remote 0x8dfbb90>, «RBDDriver (ceph conf-'/etc/ceph/ceph.conf', rbd user-'nova', pool='vms') at remote 0x37cd590>, 'b527ea7a-da48-4bbd-947c 
at /usr/src/debug/Python-2.7.5/Objects/abstract.c:2529 
#13 0x00007f5ea92be0a5 in instancemethod call (func=<function at remote 0x6ae8410», 
arg-(«RBDVolumeProxy at remote 0x8dfbb90>, «RBDDriver (ceph conf-'/etc/ceph/ceph.conf', rbd user-'nova', pool='vms') at remote 0x37cd590>, 'b527ea7a-da48-4bbd-947d-8ef0546cf 
at /usr/src/debug/Python-2.7.5/0bjects/classobject.c:2602 
#14  0x00007f5ea92af0b3 in PyObject Call (func=func@entry=<instancemethod at remote 0x9199500>, 
arg=arg@entry=(<RBDDriver (ceph conf-'/etc/ceph/ceph.conf', rbd user-'nova', pool='vms') at remote 0x37cd590>, 'b527ea7a-da48-4bbd-947d-8ef0546cf87---Type «return» to contir 
$15  0x00007f5ea9306057 in slot tp init (self-«optimized out», 
args=(<RBDDriver (ceph conf-'/etc/ceph/ceph.conf', rbd user-'nova', pool='vms') at remote 0x37cd590>, 'b527ea7a-da48-4bbd-947d-8ef0546cf87b disk'), kwds={'read only': True, 
$16 0x00007f5ea9304d6f in type call (type-«optimized out», 
args- («RBDDriver (ceph conf-'/etc/ceph/ceph.conf', rbd user-'nova', pool='vms') at remote 0x37cd590>, 'b527ea7a-da48-4bbd-947d-8ef0546cf87b disk'), kwds={'read only': True, 
#17  0x00007f5ea92af0b3 in PyObject Call (func=func@entry=<type at remote Ox6bal2f0», iu B 
arg=arg@entry=(<RBDDriver (ceph conf-'/etc/ceph/ceph.conf', rbd user-'nova', pool='vms') at remote 0x37cd590>, 'b527ea7a-da48-4bbd-947d-8ef0546cf87b disk'), kw=kw@entry={'re 
#18  0x00007f5ea934325c in do call (nk-«optimized out», na-2, pp stack=0x7ffcb99c2850, func=<type at remote 0x6bal2f0») 
at /usr/src/debug/Python- 2.7.5/Python/ceval.c:4316 
#19 call function (oparg-«optimized out», pp stack=0x7ffcb99c2850) at /usr/src/debug/Python-2.7.5/Python/ceval.c:4121 
#20 PyEval EvalFrameEx 
f=f@entry=Frame 0x9112920, for file /usr/lib/python2.7/site-packages/nova/virt/libvirt/storage/rbd utils.py, line 291, in exists (self-«RBDDriver (ceph conf-'/etc/ceph/ceph. 


http: //www.hzcourse.com/resource/readl 


结合 代码 ， 发 现 是 librbd: 


6. 查 看 Python 程 序 当 前 运 


(gdb) m. 




















1 client, 
try: 





sel 


ioctx 


f.volume 
snapshot-snap name, 

















运行 位 置 


snap name = snapshot.encode('u 


driver. 


| connec 














tf8" 





L- 


) 











tpool 


>76 read only-read only)) 


driver. 


except rbd. 
with excutil 


disconnect . 


except rbd.Error: 











. Proxy (rbd. 


ImageNotFound: 
ls.save and reraise exception(): 
LOG.debug ("rbd image $s does not exist", name) 
from rados (client, 


ioctx) 


t to rados (pool) 


f snapshot else None 
Image (ioctx, name.encode('utf 
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很 明显 ，rbd_utils.py 文 件 中 第 76 行 的 代码 调用 是 从 第 74 ~ 76 行 的 rbd.Image 的 对 象 实例 化 的 调用 触发 的 。 
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ImageState 这 个 调用 在 等 待 ， 往 下 看 #7 行 ， 这 个 调用 是 /nova/virt/libvirt/storage/rbd_utils.py 的 第 76 行 触发 的 ， 具 体 下 文 后 讲解 。 
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Fob90>, driver-«F 


', rbc 


' /etc/ 


firewall driver-«NoopFirew 


7. 查 看 Python 调用 栈 

(gdb) py-bt 

#9 Frame 0Ox6d94ef0, for file /usr/lib/python2.7/site-packages/nova/virt/libvirt/storage/rbd utils.py, line 76, in init (self-«RBDVolumeProxy at remote 0x8d 
read only-read only)) 

#20 Frame 0x9112920, for file /usr/lib/python2.7/site-packages/nova/virt/libvirt/storage/rbd utils.py, line 291, in exists (self-«RBDDriver (ceph confz'/etc/ceph/ceph.conf 
read only-True): 

#24 Frame 0x90ee350, for file /usr/lib/python2.7/site-packages/nova/virt/libvirt/imagebackend.py, line 861, in check image exists (self-«Rbd(preallocate-False, ceph conf- 
return self.driver.exists(self.rbd name) 

127 Frame 0x90d2ccO, for file /usr/lib/python2.7/site-packages/nova/virt/libvirt/imagebackend.py, line 249, in cache (self-«Rbd(preallocate-False, ceph conf-'/etc/ceph/ceph.cor 
if not self.check image exists() or not os.path.exists (base): 

#31 Frame 0x711da70, for file /usr/lib/python2.7/site-packages/nova/virt/libvirt/driver.py, line 6781, in try fetch image cache (self-«LibvirtDriver( 
size=size) 
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调用 栈 告 诉 我 们 ， 是 libvirt 的 virt driver 周 用 了 rbd 的 image backend 触 发 的 。 


至 于 librbd 为 什么 会 


有 有 关 librbd 的 操作 都 放 到 单独 的 操作 系统 线程 里 做 ， 而 不 是 放 到 协 程 里 做 。 


社区 有 bug 报 告 : https://bugs.launchpad.net/nova/+bug/1607461, 


卡 在 futex 上 ， 


追踪 librdb 的 futex 调 用 才 知 道 


也 有 bug fix: https://review.openstack.org/#/c/348492, 


bug fix 包 里 了 所 有 librbd 的 RBD 对 象 、 


。 但 是 我 们 能 初步 诊断 是 因为 Ceph 集 群 不 稳定 ， 
这 样 即使 卡 住 线程 ， 也 不 会 


Image 对 象 的 实例 方法 调用 ,但 是 志 记 包 焉 对 象 初始 化 过 程 中 的 调用 ， 因 此 还 


卡 住 eventlet 的 所 有 协 程 。 


导致 ibrbd 客 户 端 卡 住 ， 


进而 导致 Nova Compute 卡 住 。 解 决 的 办 法 可 能 是 


把 所 


会 引发 卡 死 的 问题 。 需 要 再 次 修一 下 ， 将 rbd.Image 的 对 象 实例 化 也 放 到 单独 的 


操作 系统 线程 里 做 : http://gerrit.corp.awcloud.com/#/c/11691, 


修改 了 Nova 代 码 以 后 ， 没 有 再 出 现 卡 住 的 现象 ， 但 是 仍然 不 能 解决 rebuild instance 用 时 太 长 的 问题 。 参 考 Ceph 的 官网 配置 说 明文 档 后 ， 最 后 推测 是 因为 Ceph 的 OSD 掉 线 的 超时 时 间 配 置 得 太 长 ， 导 
致 掉 线 节点 的 OSD 服 务实 际 已 经 离线 了 ，Ceph Monitor 并 没有 将 其 标记 成 离线 。 接 着 Nova 去 操作 Ceph 时 ，librbd 还 是 去 找 掉 线 的 OSD， 连 不 上 卡 住 。 把 相关 超时 时 间 全 部 修改 短 之 后 ，Evacuate 操 作 就 
能 很 快 成 功 了 。 


具体 修改 的 参数 如 下 所 示 ， 参 数 的 意义 参考 官方 文档 : http://docs.ceph.com/docs/master/rados/configuration/mon-osd-interaction/, 


8. 调 整 ceph.conf 参 数 
[mon] 


mon osd min down reporters = 2 
mon osd report timeout = 30 








10.9 本章 小 结 


本 章 主要 讲解 了 Nova 的 源码 结构 、 动 手 实验 、 新 的 V2.1 版 本 的 API 及 部 分 代码 示例 。 


第 11 章 ”Neutron 组 件 


Neutron 的 设计 目标 是 实现 “网 络 即 服务 ”， 为 了 达到 这 一 目标 ， 在 设计 上 遵循 基于 “软件 定义 网 络 ” 实 现 网 络 虚 拟 化 的 原则 ， 本 章 内 容 以 OpenStack 使 用 标准 的 openvswitch plugin 为 例 进行 说 明 。 


11.1 Neutroni 


Neutron 相 对 来 说 比较 复杂 ， 涉 及 的 概念 及 理论 比较 多 ， 本 节 先 介绍 一 下 相关 的 基础 知识 。 


11.1.1 ”服务 及 组 件 介绍 


先 执 行 管 理 员 的 脚本 ， 再 执行 neutron agent-list 命 令 : 





.openrc admin 
neutron agent-list 








正常 的 输出 结果 如 图 11-1 所 示 。 


[root&control devstack]# neutron agent-list 


十 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 

| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
4 
| 
| 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 


4--------- 4------------------- +------- 4---------------- 4+--------------------------- + 
| id | agent_type | host | availability_zone | alive | admin_state_up | binary | 
二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 4+-------------------- +--------- +------------------- +------- +---------------- +--------------------------- + 
| Odaac47a-855a-4d00-ba75-5e84990c2e43 | DHCP agent | control | nova | :-) | True | neutron-dhcp-agent | 
| 1ede3785-e444-4b71-9441-41f2cObc42fe | Metadata agent | control | I 2—) | True | neutron-metadata-agent | 
| 92aibd88-dc62-4650-8071-17ebfd&8ba6a9 | Open vSwitch agent | control | | :-) | True | neutron-openvswitch-agent | 
| 9cb59cd2-0d52-4e8a-84a6-df9703afc489 | L3 agent | control | nova Lb 5-3 | True | neutron-13-agent | 
g-------------------------------------- q-------------------- 二 一 一 一 一 一 一 一 一 = 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 = +------- $---------------= 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 = - 


图 11-1 Neutron agent 服 务 列表 


Neutron 组 件 的 主要 服务 包括 neutron-server (图 11-1 中 未 显示 ) 、neutron-openvswitch-agent、neutron-dhcp-agent、neutron-l3-agent、neutron-metadata-agent。 其 中 ，neutron server 
用 于 实现 Neutron API 和 API 扩 展 ; 管理 Router、Network、Subnet、Port; 管理 IP 地 址 。neutron-openvswitch-agent 运 行 在 每 个 计算 节点 上 ; 连接 虚拟 机 到 虚拟 网 桥 和 端口 。neutron-dhcp-agent 负 
责 DHCP 配 置 ， 为 虚拟 机 分 配 IP; 开始 /停止 DHCP 服 务 器 。neutron-l3-agent 负 责 公 网 浮动 |P 地 址 和 NAT; 负责 其 他 三 层 特性 ， 如 VPN 等 。neutron-metadata-agent 用 于 提供 元 数据 服务 。 


11.1.2 ”Neutron 架构 


Neutron 的 架构 关系 如 图 11-2 所 示 。 


API Clients Neutron Server 


统一 的 Restful API 





API Plugin 
Create-net Create-net 


Create-port Create-port 


API+Plugin=Neutron Service 


图 11-2” Neutron 的 架构 关系 


内 部 RPC 通信 


Plugin-Agent( bridge ) 





左 侧 是 调用 接口 ， 中 间 是 Neutron Server (运行 在 网 络 节点 ) ， 右 侧 是 plugin-agent (运行 在 计算 节点 ) ; 外 部 使 用 统一 的 Restful API 接 口 ， 内 部 使 用 消息 队列 通信 。 


组 件 间 的 相互 天 系 如 图 11-3 所 示 。 









图 11-3 ”Neutton 组 件 间 的 相互 关系 


除了 metadata-agent， 组 件 内 部 使 用 消息 队列 进行 通信 ，Neutron Server 和 openvswitch plugin 负 责 数 据 库 的 读 写 。 


11.1.3 ”Neutron 抽象 出 的 概念 





Neutron 提 供 以 下 抽象 对 象 : networks、subnets、ports 和 routers。 每 个 抽象 对 象 都 有 了 映射 到 它们 物理 层面 的 功能 (其 中 networks 包 含 subnets) 。 


1) 网 络 (networks) : 隔离 的 L2 广 播 域 ， 一 般 归 创建 它 的 用 户 所 有 。 用 户 可 以 拥有 多 个 网 络 。 网 络 是 最 基础 的 ， 子 网 和 端口 都 需要 关联 到 网 络 上 。 


网 络 可 以 有 多 个 子 网 。 同 一 个 网 络 上 的 主机 一 般 可 以 通过 交换 机 或 路 由 器 连通 起 来 。 


2) FW (subnets) : 隔离 的 L3 域 ， 子 网 代表 了 一 组 分 配 了 IP 的 虚拟 机 。 每 个 子 网 必须 有 一 个 CIDR 并 关联 到 一 个 网 络 。1P 可 以 从 CIDR 或 者 用 户 指定 池 中 选取 。 


子 网 可 能 会 有 一 个 网 关 、 一 组 DNS 和 主机 路 由 。 不 同 子 网 之 间 L2 是 互相 不 可 见 的， 必须 通 层 网 关 〈 即 路 由 器 ) 经 过 L3 进 行 通信 。 


3) 端口 (ports) : 可 以 进出 流量 的 接口 ， 往 往 绑 定 若干 MAC 地 址 和 IP 地 址 ， 以 进行 寻 址 。 端 口 一 般 为 虚拟 交换 机 上 的 虚拟 接口 。 


虚拟 机 挂 载 网 卡 到 端口 上 ， 通 过 端口 访问 网 络 。 当 端口 有 IP 的 时 候 ， 意 味 着 它 属 于 某 个 子 网 。 


4) 路 由 (routers) : 每 个 路 由 有 一 个 网 络 使 它 能 被 一 个 网 络 和 许多 连接 到 子 网 的 接口 所 连接 。 就 像 一 个 物理 路 由 器 一 样 ， 子 网 能 通 


网 络 。 


er 


上 述 概念 在 Hotizon 界 面 创建 网 络 时 会 更 好 理解 。 


11.1.4 ”Linux 网 络 基础 


Openstack 底 层 用 了 比较 多 的 Linux 相 关 术 语 和 概念 。 


过 同一 个 路 由 访问 不 同 子 网 的 机 器 ， 并 能 通过 


‘bridge: 网 桥 ，Linux 中 用 于 表示 一 个 能 连接 不 同 网 络 设备 的 虚拟 设备 ，Linux 中 传统 实现 的 网 桥 类 似 一 个 集线器 ， 而 O 〇 VS 管理 的 网 桥 一 般 类 似 于 交换 机 。 


` brint: bridge-integration， 综 合 网 桥 ， 常 用 于 表示 实现 主要 内 部 网 络 功能 的 网 桥 。 


br-ex: bridge-external， 外 部 网 桥 ， 通 常 表示 负责 跟 外 部 网 络 通信 的 网 桥 。 


: GRE: General Routing Encapsulation， 一 种 通过 封装 来 实现 隧道 的 方式 。 在 OpenStack 中 一 般 是 基于 L3 的 gre， 即 original pkt/GRE/IP/Ethernet。 


: VETH: 虚拟 Ethernet 接 口 ， 成 对 出 现 ， 一 端 发 出 的 网 包 会 被 另 一 端 接 收 ， 可 以 形成 两 个 网 桥 之 间 的 通道 。 

< qbr: Linux bridge. 

: qvb: Neutron veth, Linux Bridge 边 。 

: qvo: Neutron veth，OVS 边 。 

TAPA: 模拟 一 个 两 层 的 网 络 设备 ， 可 以 接收 和 发 送 二 层 网 包 

TUNRA: 模拟 一 个 三 层 的 网 络 设备 ， 可 以 接收 和 发 送 三 层 网 包 。 

- iptables: Linux 上 常见 的 实现 安全 策略 的 防火 墙 软件 。 

: Vlan: 虚拟 LAN， 同 一 个 物理 LAN 下 用 标签 实现 隔离 ， 可 用 标号 为 1 一 4094。 

: VXLAN: 一 套利 用 UDP 协议 作为 底层 传输 协议 的 Ovetlay 实 现 。 一 般 将 VXLAN 作 为 VLAN 技 术 的 延伸 或 替代 者 。 


- namespace: 用 来 实现 隔离 的 一 套 机 制 ， 不 同 namespace 中 的 资源 之 间 彼 此 不 可 见 。 


11.2 ”实例 网 络 详解 


本 节 从 实例 网 络 流 的 角度 来 说 明 相关 概念 和 设备 。 


11.2.1 “硬件 配置 及 网 络 拓扑 


部 署 的 网 络 拓扑 结构 如 图 11-4 所 示 。 其 中 包含 1 个 controller 节 点 (1 块 网 卡 ) 、1 个 网 络 节 点 (4 块 网 卡 ) 和 2 个 计算 


算 节 点 (3 块 网 卡 ) 。 


路 由 的 网 关 访问 外 部 


Network Layout 


Controller Node Network Node 





Interface 1 Interface 1 Interface 2 Interface 3 Interface 4 internet 3 
10.0.0.11/24 10.0.0.21/24 10.0.1.21/24 } \(unnumbered )} \( unnumbered ) 








Compute Node 1 Compute Node 2 
Interface 1 Interface 2 Interface 3 Interface 1 bod 2 Rena 3 
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Management network Tunnel network External network 
VLAN network 
10.0.0.0/24 10.0.1.0/24 203.0.113.0/24 


图 11-4 部署 拓 扑 结构 
各 节点 的 组 件 安装 服务 如 图 11-5 所 示 。 
1.controller 节 点 
1) 运行 Neutron 数 据 库 。 
2) 运行 消息 队列 服务 。 
3) 运行 认证 。 
4) 运行 OpenStack 计 算 Nova 相 关 网 络 ， 需 配置 hova.conf 文 件 。 


5) 运行 插件 ML2。 


Service Layout 


Controller | Network Compute 
Node Node Node 
Networki | 
li Mn Open vS witch KVM Hypervisor 
Management | 

Networking — — Networking 


Switch 
ML2 Plug-in ML2 Plug-in pes some 


Networking 


C t 
| Open vSwitch Agent ， ompute 


Networking Networking 
L3 Agent ML2 Plug-in 


Networking Networking 
DHCP Agent | Open vSwitch Agent | 


Networking 
Metadata Agent 





图 11-5 各 节点 组 件 安装 服务 


2. 网 络 节点 


1) Neutron 认 证 相关 信息 需 配置 neutron.conf 文 件 。 

2) 运行 包括 Open vSwitch 服 务 ，Open vSwitch 代 理 ，L3 代 理 ，DHCP 代 理 ， 元 数据 代理 等 相关 服务 。 
3. 计 算 节 点 

1) 运行 Openstack 身 份 与 合适 的 配置 服务 需 配置 neutron.conf 文 件 。 

2) 运行 OpenStack 计 算 Nova 相 关 网 络 ， 需 配置 nova.conf 文 件 。 


3) 运行 包括 Open vSwitch 服 务 ，Open vSwitch 代 理 的 服务 。 


11.2.2 ”各 个 节点 服务 关系 及 说 明 


OpenStack 整 体 的 网 络 架构 如 图 11-6 所 示 。 

网 络 节 点 网 络 包含 的 组 件 : Open vSwitch-Agent、13-Agent、DHCP-Agent、Metadata-Agent。 网 络 节 点 的 服务 及 接口 配置 如 图 11-7 所 示 。 
网 络 节 点 的 各 接口 细节 如 图 11-8 所 示 。 

计算 节点 网 络 包含 的 组 件 : Open vSwitch-Agent， 网 桥 。 

计算 节点 服务 及 接口 配置 如 图 11-9 所 示 。 


计算 节点 的 各 接口 细节 如 图 11-10 所 示 。 
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图 11-7 网 络 节 点 服务 及 接口 配置 
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图 11-8 网 络 节点 的 接口 细节 
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图 11-9 计算 节点 服务 及 接口 配置 


Compute Node Components 


Linux Bridge Integration Bridge 


qbr br-int 


: : | Patch Patch 
| patch-tun int-br-vlan 


Tunnel Bridge VLAN Bridge 
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Patch Patch 
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图 11-10 ”计算 节点 的 接口 细节 


11.2.3 ”场景 举例 


需要 明白 以 下 两 个 流量 的 概念 : 

: 南北 网 络 : 虚拟 机 内 部 数据 到 外 部 网 络 。 

“ 东西 网 络 : 虚拟 机 之 间 通 信 。 

案例 1: 实例 在 同一 个 固定 的 IP 地 址 的 南北 网 络 流量 分 析 
实例 通过 南北 流量 访问 外 部 网 络 的 数据 流 如 图 11-11 所 示 。 
(1) 外 部 网 络 

- 网 络 : 203.0.113.0/24。 

. JP 地址: 203.0.113.101 ~203.0.113.200. 

. 实例 网 络 的 路 由 器 接口 : 203.0.113.101。 

(2) 实例 网 络 

- 网 络 : 192.168.1.0/24。 


- 网 关 地 址 : 192.168.1.1。 


Network Traffic Flow-North/South 
[Instances with a fixes IP address 
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VXLAN/GRE 
Tunnels 


i Network Node 


Router Namespace OVS Tunnel Bridge 
qrouter br-tun 
OVS Integration Patch Interface 2 
Bridge br-int patch-int 
Patch 
»atch-tun 





OVS VLAN Brudge 








int-br-vlan 
br-vlan 
int-br-ex phy-br-vlan} is) a: (unnumbered) 


Interface 4 
(unnumbered) 


Internet 





Projece network Tunnel network External network 
192.168.1.0/24 0001024. Q9 VtANnewok Q 993.0 113.0/24 


图 11-11 ”实例 访问 外 部 网 络 的 数据 流 图 
(3) 计算 节点 1 
实例 1 的 IP 地 址 : 192.168.1.11。 实 例 1 运 行 在 计算 节点 1 上 ， 并 使 用 一 个 实例 网 络 。 该 实例 向 外 部 网 络 上 的 主机 发 送 一 个 数据 包 。 
以 下 步骤 涉及 计算 节点 1: 
1) 实例 1 通过 tap 接 口 ， 把 数据 包 发 送 到 Linux 的 网 络 qbr。 
2) 安全 组 的 规则 运行 在 qbr 上 ， 对 数据 包 进 行 过 滤 。 
3) 通过 后 数据 包 由 Linux qbr 发 到 Open vSwitch 的 网 桥 br-int。 
4) Open vSwitch 的 网 桥 br-int 增 加 一 个 实例 网 络 的 tag。 
5) VXLAN 物 理 网 络 : 
Q@ 数 据 包 由 Open vSwitch 的 网 桥 br-int 发 送 到 Open vSwitch 的 网 桥 br-vlan。 
@Open vSwitch 的 网 桥 br-vlan 将 内 部 VLAN 转 换 为 真实 的 VLAN。 
@Open vSwitch 的 网 桥 br-vlan 通 过 VLAN 接 口 发 送 到 网 络 节点 。 


6) VXLAN 和 和 GRE 物理 网 络 : 









Patch Interface 3 
phy-br-vlan| (15 (unnumbered) , 


ed dd dd ed dd di 





Q@ 数 据 包 由 Open vSwitch 的 网 桥 br-int 发 送 到 Open vSwitch 的 隧道 br-tun。 
@Open vSwitch 的 网 桥 br-tun 将 通过 VXLAN 或 GRE 协 议 封 装 数据 包 并 增加 物理 网 络 tag 认 证 。 
@Open vSwitch 通 过 隧道 br-tun 发 送 到 网 络 节点 的 隧道 接口 。 
以 下 步骤 涉及 网 络 节点 : 
1) VLAN 物 理 网 络 : 
Q@VLAN 接 口 将 收 到 的 数据 包 转 到 Open vSwitch 的 VLAN 网 桥 br-vlan ; 
@ 数 据 包 由 Open vSwitch 的 VLAN 网 桥 br-vlan 转 发 到 Open vSwitch 的 br-int 桥 ; 
@Open vSwitch 的 br-int 桥 替换 物理 VLAN tag 为 内 部 tag。 
2) VXLAN 和 和 GRE 物理 网 络 : 
Q@ 数 据 包 到 Open vSwitch 通 过 隧道 br-tun。 
@ 解 包 并 增加 一 个 内 部 tag。 
@ 数 据 包 从 Open vSwitch 的 隧道 br-tun 桥 到 达 Open vSwitch 的 br-int 桥 。 
3) 实例 的 数据 包 到 达 Open vSwitch 的 br-int 桥 后 ， 再 通过 qrouter 的 命名 空间 到 qr 接口 ， 在 qr 接口 中 包含 实例 网 络 的 网 关 地 址 。 
4) 做 SNAT 后 数据 包 到 达 qg 接 口 ，qg 接 口 包含 真实 网 络 的 路 由 接口 地 址 。 
5) 实例 的 数据 包 到 qrouter 的 命令 空间 的 qg 接 口 后 ， 再 通过 qg 接 口 到 达 Open vSwitch 的 br-int 桥 中 。 
6) 数据 包 通 过 Open vSwitch 的 br-int 桥 到 达 外 部 网 络 的 br-ex 桥 。 
7) 数据 包 通 过 Open vSwitch 的 br-ex 桥 到 外 部 网 络 的 外 部 接口 。 
案例 2: 实例 在 不 同 的 网 络 上 的 东西 网 络 流量 分 析 
不 同 计算 节点 上 的 实例 的 东西 网 络 流量 分 析 图 如 图 11-12 所 示 。 

(1) 实例 网 络 1 

“网络: 192.168.1.0/24. 

- 网 关 地 址 : 192.168.1.1. 

(2) 实例 网 络 2 

“网络: 192.168.2.0/24. 

> 网 关 地 址 : 192.168.2.1. 

(3) 计算 节点 1 


实例 1 的 IP 地 址 : 192.168.1.11, 


Network Traffic Flow - East/West 
[Instances on different networks 


p» Co o c c c c c - 4 4 4 4 人 4 X o o 4 o 4 o o o X o 4 4 4 «o o o o 4 X o « X o «m o" o o o 4 - o 4 o 4 o 4 X o 4 o 4 X" 4 X 4 o — -— -- - S 








OVS Integration 
Bridge br-int 





Linux Bridge 
qbr 





Interface 2 
10.0.1.X/24 


Interface 3 
(unnumbered) 


i i eh ,i ed, ‘i din i iin i i E 


VXLAN/GRE 
Tunnels 


a --— -— c í— — i— o i— o— — o -— — o o o c o o o o c o we2£ rf o www c— o o o—-— o 9 o c -— o o ffx er —— o -— -— — -— -— —-— o -— -— — -— É-— c o -— a £2 £ ££ 2£2£2£ 22 597" "= "= - - 









OVS Integration 
Bridge br-int 
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Project network 1 Project network 2 Tunnel network 
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图 11-12 不 同 实例 间 东 西 网 络 流量 分 析 图 
(4) 计算 节点 2 
实例 2 的 IP 地 址 : 192.168.2.11。 
说 明 : 1) 实例 1 驻 留 在 计算 节点 1 和 使 用 实例 网 络 1。 
2) 实例 2 驻 留 在 计算 节点 2 和 使 用 实例 网 络 2。 


3) 两 个 实例 网 络 驻 留 在 同一 个 路 由 器 上 。 


4) 实例 1 的 数据 包 到 达 实 例 2 的 过 程 。 

以 下 步骤 涉及 计算 节点 1: 

1) 实例 1 通过 tap 接 口 把 数据 发 到 Linux 的 qbr 网 桥 。 

2) 在 Linux 的 qbr 网 桥 上 的 安全 组 规则 对 数据 包 进 行 过 渡 。 

3) 过 滤 后 数据 包 由 Linux 的 qbr 网 桥 发 到 Open vSwitch 的 网 桥 br-int。 

4) Open vSwitch 的 网 桥 br-int 增 加 实例 网 络 2 的 内 部 tag。 

5) VXLAN 物 理 网 络 : 

Q@ 数 据 包 由 Open vSwitch 的 网 桥 br-int 发 送 到 Open vSwitch 的 网 桥 br-vlan。 

@Open vSwitch 的 网 桥 br-vlan 将 内 部 VLAN tag 转 换 为 实例 网 络 1 的 VLAN tag. 

@ 数 据 包 由 Open vSwitch 的 网 桥 br-vlan 通 过 VLAN 接 口 发 送 到 网 络 节点 的 VLAN 接 口 。 
6) VXLAN 和 和 GRE 物理 网 络 : 

Q@ 数 据 包 由 Open vSwitch 的 网 桥 br-int 发 送 到 Open vSwitch 的 隧道 网 桥 br-tun。 
@Open vSwitch 的 网 桥 br-tun 将 通过 VXLAN 或 GRE 协 议 封装 数据 包 并 增加 实例 网 络 1 的 tag 认 证 。 
数据 包 通 过 Open vSwitch 的 隧道 桥 br-tun 发 送 到 网 络 节点 的 隧道 接口 。 

以 下 步骤 涉及 网 络 节点 : 

1) VLAN 物 理 网 络 : 

Q@VLAN 接 口 将 收 到 的 数据 包 转 到 Open vSwitch 的 VLAN 网 桥 br-vlan。 
数据 包 由 Open vSwitch 的 VLAN 网 桥 br-vlan 转 发 到 Open vSwitch 的 br-int 网 桥 。 
GOpen vSwitch 的 br-int 网 桥 蔡 换 实例 网 络 1 的 VLAN tag 为 内 部 tag。 

2) VXLAN 和 和 GRE 物理 网 络 : 

Q@ 数 据 包 从 隧道 到 达 Open vSwitch 隧 道 br-tun。 

@ 解 包 并 增加 一 个 实例 网 络 1 的 内 部 tag。 

@ 数 据 包 从 Open vSwitch 的 隧道 br-tun 桥 发 送 到 Open vSwitch 的 br-int 网 桥 。 

3) 到 Open vSwitch 的 br-int 网 桥 后 ， 数 据 包 到 达 qrouter 的 命名 空间 的 qr-1 接 口 ，qr-1 接 口 包 含 实例 网 络 1 的 网 关 地 址 。 
4) 数据 包 到 达 qrouter 的 路 由 命名 空间 的 qr-2 接 口 ，qr-2 接 口 包含 实例 网 络 2 的 网 关 地 址 。 
5) 数据 包 从 qrouter 的 命令 空间 转发 到 Open vSwitch 的 br-int 网 桥 。 

6) 在 Open vSwitch 的 br-int 网 桥 ， 增 加 实例 网 络 2 的 内 部 tag。 

7) VLAN 物 理 网 络 : 

@ 数 据 包 从 Open vSwitch 的 br-int 网 桥 到 达 Open vSwitch 的 VLAN 网 桥 br-vlan。 
@ 在 Open vSwitch 的 br-vlan 网 桥 增加 一 个 实例 网 络 2 的 tag。 

GOpen vSwitch 的 br-vlan 网 桥 通 过 VLAN 接 口 发 送 到 计算 节点 2 的 VLAN 接 口 。 

8) VXLAN 和 和 GRE 物理 网 络 : 

@ 数 据 包 从 Open vSwitch 通 过 隧道 br-int 发 送 到 Open vSwitch 隧 道 br-tun。 

@Open vSwitch 的 网 桥 br-tun 将 通过 VXLAN 或 GRE 协 议 封装 数据 包 并 增加 实例 网 络 2 的 tag 认 证 。 
@ 数 据 包 从 Open vSwitch 的 隧道 br-tun 网 桥 发 送 到 计算 节点 2 的 隧道 接口 。 

以 下 步 又 涉及 计算 节点 2: 

1) VLAN 物 理 网 络 : 

Q@ 数 据 包 从 VLAN 接 口 发 送 到 Open vSwitch 的 网 桥 br-vlan。 

Qui tA Open vSwitch 的 网 桥 br-vlan 发 送 到 Open vSwitch 的 网 桥 br-int。 

@Open vSwitch 的 br-int 网 桥 用 内 网 tag 蔡 换 实例 网 络 2 的 VLAN tag. 

2) VXLAN 和 和 GRE 物理 网 络 : 

Q@ 数 据 包 从 隧道 (VXLAN 和 GRE) 发 送 到 Open vSwitch 的 隧道 br-tun。 

@ 解 包 并 增加 一 个 实例 网 络 2 的 内 部 tag。 


@ 数 据 包 从 Open vSwitch 的 隧道 br-tun 网 桥 发 送 到 Open vSwitch 的 br-int 网 桥 。 


3) 数据 包 从 Open vSwitch 的 br-int 网 桥 发 送 到 Linux 的 qbr 网 桥 。 

4) 安全 组 规则 对 数据 包 过 滤 。 

5) 通过 后 数据 包 由 Linux 的 qbr 网 桥 发 送 到 实例 网 络 2 的 tap 接 口 。 

说 明 : 以 上 示例 基于 OVS 插 件 ， 更 多 示例 及 Linux 网 桥 的 案例 参考 官方 最 新 分 析 : 
- https://docs.openstack.org/mitaka/networking-guide/deploy-ovs.html。 

- https://docs.openstack.org/mitaka/networking-guide/deploy-lb.html。 


对 于 上 面 流量 的 理解 可 以 使 用 如 下 命令 进行 验证 : 





brctl show 

ovs-vsctl show 

ip netns 

ip netns exec * ipa 


Qs; 


*AX ip netns 显 示 的 结果 内 容 之 一 。 





11.3 ” ”Neutron 的 源码 分 析 


本 节 开 始 分 析 Neutron 的 源码 结构 ， 需 要 把 Neutron 工 程 导 入 PyCharm 或 相关 工具 中 。 


11.3.1 ”目录 结构 


Neutron Mitaka 版 的 目录 结构 如 图 11-13 所 示 。 





~ PF neutron. ege—info 
H = rally -Jobs 
Jm releasenotes 


«E tools 


jh [=] .Ccowveragerc 
en E. 


oE = neutr or 


1. 根 目录 文件 说 明 





.gitignore 
.gitrewiew 
.mailmap 
.pylintrc 

. testr. cont 

| babel. cfg 

ust CONTRIBUTING. rst 
HACKING. rst 

[=] LICENSE 
MANIFEST. in 


"€ openztack-common. conf 











requirements. txt 


| run tests. sh 





| setup. cig 


setup. py 
=| test-requirements. txt 


= 


net TESTING. rst 










: requirements.txt: 当前 环境 的 依赖 包 列 表 。 
` setup.py: 打包 工具 。 
. setup.cfg: 函数 和 命令 的 对 应 关系 ， 如 图 11-14 所 示 。 
[entry points] 
console scripts — 
neutron-bgp-dragent = neutron. cmd eventlet agents bgp dragent:main 
neutron-dh-manage = neutron. db. migration cli:main 
neutron debug = neutron. debug. shell: main 
neutron-dhcp-agent = neutron. cmd. eventlet. agents. dhcp: main 
neutron -keepalived-state-change = neutron. cmd keepalived state change:main 
neutron-ipset-cleanup = neutron. cmd. ipset cleanup:main 
neutron -l3-agent = neutron. cmd. eventlet. agents. 13. main 


neutron -linuxbridge-agent = neutron. cmd. eventlet. plugins. linuxbridge neutron agent:main 
neutron -linuxbridge-cleanup = neutron. cmd. linuxbridge cleanup:main 
neutron-macvtap- agent = neutron. cmd. eventlet plugins.macvtap neutron agent:main 
neutron metadata-agent = neutron. cmd. eventlet. agents. metadata:main 
neutron-netns-cleanup = neutron. cmd. netns cleanup:main 


neutron-ns-metadata-proxy 


neutron-openvswitch-agent 


neutron-ovs-cleanup = neutron. cmd. ovs cleanup:main 


neutron. cmd. eventlet. agents. metadata proxy:main 


neutron. cmd. eventlet. plugins. ovs neutron agent:main 
arua in Pa ia n iP p ae mx E E 


neutron-pd-notify = neutron. cmd. pd notify:main 





neutron-rpc-server = neutron. cmd. eventlet. server:main rpc eventlet 
a n e rin n pia P aia aia aa i T n uin aia aia aia aie Pn an n P 


neutron-rootwrap = oslo_rootwrap, cmd:main 
neutron-rootwrap-daemon = oslo rootwrap. cmd: daemon 


neutron-usage-audit = neutron cmd eventlet usage audit: main 
neutron-metering-agent = neutron. cmd. eventlet. services. metering agent: main 
neutron-sriov-nic-agent = neutron. cmd. eventlet plugins. zriov nic neutron agent:main 
os pn pn gn aia oia au a on rn pn pn aia pn, oia gn aia in an ga a os n p p p pn ia aT — X 
neutron-sanity-check = neutron. cmd. sanity check: main 
neutron. core plugins = 
ml2 = neutron.pluginz.mlZ.plugin:Ml2ZPlugin 
图 11-14 ”Neutton 命 令 和 函数 的 对 应 关系 


图 11-14 中 阴影 处 对 应 的 代码 在 neutron/cmd/eventlet/server/_init_ .py: main () ， 如 图 11-15 所 示 。 


B- T4 neutron 
E [1 agent 
E- = api 
E- [1 callbacks 
ae 5 cmd 
; Ee BD eventlet 
由 - [1 agents 
由 - [1 plugins 
EF = server 


$ - Services 


pee inii .py 

EL. usage audit.py 
g- Rs sanity 
| imt copy 


lh ipset cleanup.py 


; keepalived state change. py 


; linuxbridge cleanup. py 


netns cleanup.py 


; ovg cleanup. py 


; pd notify. py 


i sanity check. py 





comm or. 


a P3 
E [1 core extensions 
a 


2. 目 录 说 明 


对 主要 目录 结构 的 说 明 如 图 11-16 所 示 。 


- 
E 
E 
: 
p 

Lh 


[import CR 


€ 
后 de 王 FERA): 


3 server. boot server main neutron server) 


def main neutron server (): 
: iË cfg. CONF. web framework == "legacy 
wsgi_eventlet. ewentlet_wsgi_serwer () 
else: 


白 wsgi pecan. pecan wsgi server [] 


图 11-15 %4 P main Jk 
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buted on an “AS IS" BASIS, WITHOUT 


neutron/ 
- bin (二 进 制 文件 目录 ) 
H devstack ( DevStack H 5€) 
一 一 doc (PA x, £f API 等 参考 链接 ) 
H etc (配置 文件 目录 ， 包括 neutron, 13 agent, dhcp agent 等 配置 示例 ) 
H neutron (Neutron 主要 实现 目录 ) 
| 一 一 agent (各 种 agent Hoe, WG D. D 等 ) 
|  F——api (API H3&) 
| I—-— callbacks 
| 一 一 cmd (命令 行 命令 目录 ) 
| 一 一 common (公共 库 目 录 ) 
|  L—-— core extensions (core 扩展 目 录 ) 
| H db (数据 库 操作 目录 ) 
| 于 一 debug (debug 目录 ) 
|  LF—-— extensions (功能 扩展 目录 ) 
| H|— locale (本 地 语言 目录 ) 
| L—-— notifiers (Nova 组 件 消息 目录 ) 
| “一 一 openstack (缓存 目录 ) 
| 一 一 plugins (插件 目录 ) 
| L—— scheduler (服务 调试 目录 ) 
| 
| 
| 
+ 
L 

















— server (服务 人 口 目录 ) 
I—— services (服务 实现 目录 ) 
-一 一 tests (单元 、 功 能 测试 目录 ) 
releasenotes (PH H 3K) 

tools (工具 和 脚本 目录 ) 


图 11-16 主要 目录 结构 说 明 








oon 


不 同 版 本 ， 目 录 结 构 可 能 会 有 不 同 。 


11.3.2 重要 目录 详解 


上 一 节 所 述 目录 中 ， 重 要 的 目录 包括 api、db、scheduler 等 ， 这 里 重点 讲解 plugins、agent、Services 目 录 ，。 
1.plugins 详 解 
plugins 目 录 结 构 如 图 11-17 所 示 。 


Neutron 中 ， 实 现 一 个 插件 包括 两 部 分 的 内 容 : 一 部 分 是 与 数据 库 db 打 交道 的 ， 称 为 plugin (虽然 都 是 plugin， 但 是 这 个 是 具体 实现 中 的 plugin) ， 另 一 部 分 是 调用 具体 的 网 络 设备 真正 干 活 的 ， 称 为 


agent, 


与 db 进行 交互 的 plugin 在 功能 上 有 很 多 重复 ， 所 以 在 代码 上 有 很 多 重复 ， 因 此 Neutron 中 提供 了 一 个 公共 的 plugin 一 一 ML2 (Module Layer2) plugin, 


plugins 
fe) [D] common 
四- = hyp erw 
es e mili 
: E E] common 
ai 户 drivers 
-E agent 
D 12pop 
-E linuxbridge 
= macwtap 
-D mech sriov 
Án openvswitch 
| init .py 





helpers. py 


l me ch agent. py 


|j type flat. py 

| type geneve.py 
à type gre.py 

JU type local. py 


Be i type tunnel. pr 


type vlan. py 


type wxlan. py 
a de Eria 


图 11-17 plugins A 3k 2544 





ML2plugin 的 第 一 个 作用 是 提供 与 数据 库 交 互 的 公共 plugin。 


ML2 的 第 二 个 作用 是 实现 支持 多 种 pulgin (原先 使 用 Linux bridge， 就 不 能 用 OpenvSwitch) ，ML2 通 过 MechanismDriver 实 现 。MechanismDriver 的 作用 是 将 agent 的 类 型 agent type 和 vif type 关 
联 ， 这 样 vif_type 就 可 以 直接 通过 扩展 API 设 置 了 ， 如 图 11-18 所 示 。 


def init (self): 

sg enabled = securitygroups rpc.is firewall enabled(í) 
hybrid plug required = (mot cfg. CONF. SECURLIYGROUP. firewall driver or 

ctg. CONF. SECURIITGROUP. firewall driver im | 

IPIABLES FW DRIVER FUIL, “iptables hybrid )) amd sg enabled 
vif details = {portbindings. CAP FORT FILTER: sg enabled, 
portbindings. OVS HYBRID PLUG: hybrid plug required] 

super lÜpenvswitchMechanismDrivwer, self). init (4 

constants. AGI STER OFS, 

portbindings. VIF TYPE OVS, 

wit details) 

图 11-18 agent 的 类 型 的 代码 
ML2 的 第 三 个 作用 是 支持 不 同 的 网 络 拓扑 ， 如 Flat、VLAN、GRE、VXLAN， 直 接 在 ml2_conf.ini 这 个 配置 文件 中 配置 即 可 。 


2.agent 详 解 


agent 任 Neutron 的 代码 位 置 如 下 : 


neutron\agent 





目录 内 容 如 图 11-19 所 示 。 





-C common 

-C dhep 

-J12 

-0013 

- 1 linux 

-CJ metadata 
-C evsdb 

= windows 

| int .py 





JB. dhcp agent.py 
J. firewall. py 
8.13 agent. py 





rpe. py 





图 11-19 agent E Ki 
在 Neutron 中 ，agent 有 L2、L3 等 ， 一 般 运 行 在 计算 节点 上 ; 分 别 对 应 L2plugin、L3-router plugin, FW plugin, LB plugin 
3.services 详 解 


services 在 Neutron 的 代码 位 置 : 


， 这 些 plug 


metadata agent. py 


A, securitygroups rpc. py 


in 一 般 都 运行 在 网 络 节点 。 





neutron Nservices 


目录 内 容 如 图 11-20 所 示 。 


EH = Services 

“ad auto allocate 
J= bgp 

- [1 external dns 
D firewall 

-C9 flavors 

-013 router 
-ÖJ metering 

"D network ip availability 
„PF aos 

-E rbac 

[3 tar 

- [1 timestamp 

a, init__.py 











provider configuration. py 





a a MY 


图 11-20 services A 3& 2535 


在 Neutron 中 的 agent 有 L2、L3 等 ， 一 般 运行 在 计算 节点 上 ， 分 别 对 应 L2plugin (ML2 和 monolithic) , L3-router plugin, FW plugin, LB plugin， 这 些 plugin 一 般 都 运行 在 网 络 节点 。 


11.3.3 Neutron 启 动 分 析 


主 启 动 文件 如 下 : 


/usr/bin/neutron-server 


内 容 如 下 : 


#!/usr/bin/python 
# PBR Generated from u'console scripts' 








import sys 





from neutron.cmd.eventlet.server import main 











if name -- " main ": 
sys.exit (main()) 





调用 server/wsgi_eventlet.py， 代 码 如 下 : 








def eventlet wsgi server(): 
neutron api = service.serve wsgi (service.NeutronApiService) 
start api and rpc workers (neutron api) 



































def start api and rpc workers (neutron api): 
pool = eventlet.GreenPool () 








api thread = pool.spawn (neutron api.wait) 


try: 
neutron rpc = service.serve rpc() 
except NotImplementedError: 
LOG.info( LI("RPC was already started in parent process by " 


plugin.")) 


























else: 
rpc thread = pool.spawn (neutron rpc.wait) 


plugin workers = service.start plugin workers () 
for worker in plugin workers: 
pool.spawn (worker.wait 














— 





# api and rpc should die together. When one dies, kill the other. 
rpc thread. link (lambda gt: api thread.ki 110) 
api thread.link(lambda gt: rpc thread.kill()) 


























Ct ct 











pool.waitall () 
main 函 数 主要 完成 两 部 分 工作 : 
1) 启动 RPC API, 
2) 以 协 程 方式 启动 Restful API 
1.service.serve rpc 


neutron.service.serve_rpc 最 重要 的 工作 是 启动 各 个 插件 的 RpcWorker， 代 码 追 踪 如 下 : 


plugin = manager.NeutronManager.get plugin() 
service plugins - ( 
manager.NeutronManager.get service plugins ().values()) 














Q 


fg.CONF.rpc workers < 1: 


cfg.CONF.set_override('rpc workers', 1) 


















































# If 0 < rpc workers then start rpc listeners would be called in a 
# subprocess and we cannot simply catch the NotImplementedError. It is 
4 simpler to check this up front by testing whether the plugin supports 





4 multiple RPC workers. 
if not plugin.rpc workers supported(): 
OG.debug("Active plugin doesn't implement start rpc listeners") 
if 0 « cfg.CONF.rpc workers: 

LOG.error( LE("'rpc workers - $d' ignored because " 
"start rpc listeners is not implemented."), 
cfg.CONF.rpc workers) 
raise NotImplementedError () 

















(Est 


























try: 





# passing service plugins only, because core plugin is among them 
rpc = RpcWorker (service plugins) 

# dispose the whole pool before os.fork, otherwise there will 

# be shared DB connections in child processes which may cause 

# DB errors. 
LOG.debug('using launcher for rpc, workers-$s', cfg.CONF.rpc workers) 
session.dispose () 
launcher = common service.ProcessLauncher (cfg.CONF, wait interval=1.0) 
launcher. launch service (rpc, workers-cfg.CONF.rpc workers) 


















































而 RpcWorker 最 重要 的 工作 是 调用 plugin 的 start_rpc listeners 来 监听 消息 队列 ， 代 码 追 踪 如 下 : 


class RpcWorker (worker.NeutronWorker): 
"""Wraps a worker to be handled by ProcessLauncher""" 
start listeners method = 'start rpc listeners' 























def init (self, plugins): 
self. plugins = plugins 
lf. servers - [] 





























def start (self): 
super (RpcWorker, self).start() 
































for plugin in self. plugins: 
if hasattr(plugin, self.start listeners method): 
try: 








servers = getattr (plugin, self.start listeners method) () 
except NotImplementedError: 

continue 
self. servers .extend (servers) 























RPC 模 块 是 启动 各 个 插件 的 RpcWorker， 监 听 各 个 agent 的 RPC 消 息 ， 是 由 service.py 与 相应 的 plugin 的 RPC 代 码 实现 的 。 
2.Rest API 部 分 


Rest API 代 码 追 踪 如 下 : 





def serve wsgi (cls): 


try: 
service = cls.create() 
service.start () 

except Exception: 


with excutils.save and reraise exception () : 











LOG.exception( LE 


return service 


service.start () Biself.wsgi app- run wsgi (self.app name) 


def 





app = 
i 








con 





e. eEror: 





run wsgi(app name): 
fig.load paste app(app name) 
f not app: 


LI 








LOG.error( 


return 
return run wsgi app (app) 


def 





server 
server.start(app, ci 


LOG.inf 


LI 











o( 


return server 





("Neut 
{'host' 


run wsgi app (app) : 
wsgi.Server ("Neutron") 
Fg.CONF.bind | port, 





E('No known API 


('Unrecoverab] 
for detail 








S. 


")) 








applications conf 


cfg.CONF 


workers- | get. api workers () ) 











zC 


api-paste.iniB P3 3H P: 


[composite:neutron] 


use 
P 
/v2.0: 


[composite:neu 
use = call:neu 














egg: Paste#urlmap 
neutronversions 
neutronapi v2 0 


tronapi v2 0] 


tron.auth:pipeline factory 


g.CONF.bind host, 


tron service started, 






































listening on $ (host) 
'port': 


please check log ' 


， 而 该 函数 最 重要 的 工作 是 从 api-paste.ini 中 加 载 APP 并 启动 ， 代 码 追 踪 如 下 : 





')) 


figured. 


.bind host, 


S:$ (port 
Fg.CONF.bind port 








C1 























noauth = cors request id catch errors extensions neutronapiapp v2 0 

keystone = cors request id catch errors authtoken keystonecontext extensions neutronapiapp v2 0 
[filter:extensions] 

paste.filter factory = neutron.api.extensions:plugin aware extension middleware factory 
[app:neutronversions] 

paste.app factory = neutron.api.versions:Versions.factory 

[app:neutronapiapp v2 0] 

paste.app factory - neutron.api.v2.router:APIRouter.factory 























实例 化 neutron/api/v2/router.py 中 的 APIRouter， 代 码 追 踪 如 下 : 


class API 


Rout 


# 一 个 工厂 类 方法 


@c] 


LaSSmel 





thod 








def 


factory ( 


cls, global 


C 


ter (base wsgi.Router): 





onfig, 


** local 





| confi 








nf 





return cls(**1local 


# 真正 调用 的 实例 化 方 ; 


YA 











def 


init 





(self 


** loca 


208 


1 


ig) 


| config): 





, 


mapper = routes mapper .Mapper () 


# 获 取 NeutornManage 的 core plugin, ike ME /etc/neutron/neutron. con! 


#core Pin 2.plugin.Ml2Plugin 





neul 








tron.plugins.m] 









































H 
AE 








F,devstack 










































































































































































































































































lugin = manager.NeutronManager.get plugin() 
PAREEK F extensions 
ext mgr = extensions.PluginAwareExtensionManager.get instance () 
ext mgr.extend resources ("2.0", attributes .RESOURCE ATTRIBUTE MAP) 
col kwargs = dict (collection actions=COLLECTION ACTIONS, 
member actions-MEMBER ACTIONS) 
# 定 义 的 局 部 方法 
def _Map_resourc (collection, resource, params, parent=None) : 
allow bulk = cfg.CONF.allow bulk 
allow pagination = cfg.CONF.allow pagination 
allow sorting = cfg.CONF.allow sorting 
controller = base.create resource ( 
collection, resource, plugin, params, allow bulk=allow bulk, 
parent=parent, allow pagination=allow pagination, E 
allow sorting-allow sorting) 
path | prefix - None 
if parent: 
path prefix = "/$s/($s id)/$s" $ (parent['collection name'], 
parent['member name'], 
collection) B 
mapper kwargs = dict (controller-controller, 
requirements=REQUIREMENTS, 
path prefix=path prefix, 
**col kwargs) 
# 将 这 些 resource 加 进 router 中 n 
return mapper.collection(collection, resource, **mapper kwargs) 
mapper.connect('index', '/', controller-Index (RESOURCES) ) 
# 遍历 ('network': 'networks', 'subnet': 'subnets','port': 'ports') 
# 添加 controller 
for resource in RESOURCES: 
map resource (RESOURCES [resource], resource, 
attributes.RESOURCE ATTRIBUTE MAP.get( 
RESOURCES[resource], dict())) 
resource registry.register resource by name (resource) 


可 以 看 出 ， 添 加 的 controller 类 型 主要 分 为 三 类 : Ml2Plugin, extensions/*.py, plugins/*.py. 


对 于 Resource: MI2Plugin 的 实现 ， 代 码 追 踪 如 下 : 


class Ml2Plugin(db base plugin v2.Ne 





该 方法 继承 了 NeutronDbPluginV2， 在 NeutronDbPluginV2 中 实现 了 抽象 的 方法 Neutron-PluginBaseV2， 在 该 方法 中 实现 了 create subnet () , 


get subnets 


基本 上 可 以 说 有 一 个 接口 类 (如 上 面 的 NeutronPluginBaseV2) , 


在 请 求 进 入 APIRouter 之 前 ， 会 先 经 过 RequestldMiddleware (请 求 header 中 添加 openstack.request id) 、 
plugin aware extension middleware factory 等 几 个 filter 的 处 理 ， 前 三 个 filter 比 较 直 观 ， 


utronDbPluginV2, 





dvr mac db.DVRDbMixin 
external | net 
sg db rpc. Securi 
tschedulers db.AZDhcpAgent 
| pair db. AllowedAddressPairsMixin, 


agent 
addr 





t db. 





tyGro 


, 


upServerl 


External net db mixin, 
RpcMixin, 








vlant 
exi 
ne 











cm 


transparent 
tradhcpopt db. 
tu db.Netm 








tu db 





tSchedulerDbMixin, 








mixin, 


t db.Vlantransparent db mixin, 
..ExtraDhcpOptMixin, 


address scope db.AddressScopeDbMixin): 


O 等 操作 。 


update subnet () 、get subnet () 、 


在 其 中 定义 抽象 方法 ， 然 后 由 一 个 具体 的 db 类 来 实现 (如 NeutronDbPluginV2， 这 里 是 采用 SQLAIchemy 来 完成 db 模型 的 ) 。 


CatchErrorsMiddleware (错误 处 理 ) 、keystone 权 限 验 证 以 及 


plugin aware extension middleware factory 初 始 化 了 extensions 目 录 下 的 Resource， 如 图 11-21 所 示 。 


extensions 下 的 securitygroup.py 中 的 get_resources 方 法 可 以 处 理 security group 和 security_ group_rule 两 类 请 求 。 


Neutron 的 时 候 无 须 像 Nova、Glance 等 要 执行 DBSync 的 原因 了 。 


11.4 ” Neutron 组 件 扩展 


1 


由 DD core_extensions 
由 - E db 

由 [73 debug 

=} E extensions 


— 


.4.1 


es \ 
e address s 


e agent. py 


- PY 


cope. py 


$ allowedaddresspairs. py 
^d auto allocated topology.py 


$ availabil 
b bgp. py 


ity zone.py 


h bgp dragentscheduler. py 
i, default subnetpools. py 


 dhcpagent 
$ dns. py 


scheduler. py 


b extra dhcp opt.py 


dvr.py 
L external net. py 


! extraroute.py 
a, flavors. py 





odef plugin_aware_extension_middleware_factory (global_config, 


pM J? ff 


def factory (app): 
ext mgr = PluginAwareExtensionManager. get_instance() 
return ExtensionMiddleware (app, ext mgr-ext mgr) 


return factory 


图 11-21 extensions 的 plugin awate extension middleware factory 7 法 


didis T o murs 一 d xe . 
re 1 OCal config): 


到 这 里 ，Neutron Server 就 基本 启动 了 ， 后 续 操 作 就 是 加 载 配置 、 路 由 各 种 资源 、 等 待 请 求 等 。 其 中 路 由 哪些 资源 完全 是 由 配置 文件 来 决定 的 。 在 启动 的 过 程 中 也 会 初始 化 db， 这 也 就 是 为 何在 安装 


代码 分 析 小 结 : 


Neutron server 启 动 一 执行 heutron/server/ init .py: main () : 


1) 启动 RPC 协 程 一 加 载 Plugin 一 初始 化 rpcworker 一 创建 rnpcconsumer 一 监听 agent 的 RPC 消 息 一 处 理 RPC 消 息 。 


2) 启动 WSGI 服 务 协 程 一 加 载 api_paste.ini 中 的 APP 一 初始 化 socket 并 监听 API 请 求 一 路 由 请 求 到 具体 的 函数 一 处 理 API 请 求 一 返回 response。 


这 里 以 Neutron 的 扩展 为 例 进行 讲解 。 


编写 代码 


1. 修 改 plugin.py 文 件 


进入 如 下 目录 : 





/opt/stack/neutron/neutron/plugins/ml2 


编辑 plugin.py 文 件 ， 增 加 如 下 内 容 : 








Supported exi 
"security-group", 


"quotas", 


"dhcp agent scheduler", 





"multi-provider", 





"extra dhcp opt", 


"net-mtu", "v] 


"network avail 








ability zone", 








"default-subnetpools", 





"test"] 





tension aliases 
"agent", 


= ["provider", 





def create test (seli 
LOG.error("YEDC TEST") 

















"allowed-address-pairs", 
"subnet allocation", 
lan-transparent", 

"address-scope", 
"availability zone", 


f, context, test): 


"external-net", 


"pinding", 





删除 plugin.pyc 文 件 : 





rm plugin.pyc 


2. 创 建 test.py 文 件 


进入 如 下 目录 : 





/opt/stack/neutron/neutron/extensions 


创建 test.py 文 件 ， 内 容 如 下 : 








opyright 2012 VMware, I 
ll rights reserved. 











not use 





distribu 


a copy of 





this 





http: //www.apache.org/] 


Unless required by appl 


file excep! 


t in compl 





F the License a 











licenses/LICE 





NSE 




















WARRANT 





























License 


# c 
# A 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 





import abc 





from oslo config import cfg 





under the License. 











ES OR CONDITIONS OF ANY K] 





Licensed under the Apache License, Version 2.0 


.0 


(the "License"); 
liance with the License. You may obtain 


you may 





icable law or agreed to in writing, software 
ted under the License is distributed on an "AS IS" BASIS, WITHOUT 
IND, either express or implied. See the 























for the specific language governing permissions and limitations 











































































































from neutron. 118n import _ 
from neutron.api import extensions 
from neutron.api.v2 import attributes as attr 
from neutron.api.v2 import resource helper 
from neutron.common import exceptions as nexception 
from neutron.pecan wsgi import controllers 
from neutron.plugins.common import constants 
from neutron import manager 
from neutron.api.v2 import base 
from neutron.quota import resource registry 
RESOURCE ATTRIBUTE MAP = { 
'tests': { 
'name': {'allow post': True, 'allow put': True, 
'validate': ('type:string': attr.NAME MAX LEN], 
'is visible': True, 'default': ''], 
‘admin state up': {'allow post': True, ‘allow put': True, 
'default': True, 
'convert to': attr.convert to boolean, 











'is visible': True}, 
'status': {'allow post': False, 'allow put': False, 
'is visible': True}, B 
"tenant id': {'allow post': True, 'allow put': False, 
'required by policy': True, 
'validate': {'type:string': attr.TENANT ID MAX LEN}, 
'is visible': True} mM 


























} 
} 
#RESOURCE ATTRIBUTE MAP 决定 是 否 对 属性 进行 制约 ;allow_ put 决定 是 否 允 许 用 户 进行 修改 ， 即 
#update; allow Post 决定 是 否 通过 用 户 传 来 数值 进行 填充 ， 如 idq， 此 值 为 False， 如 果 用 户 提交 过 来 的 
# 数 据 中 有 id， 则 出 错 ， 也 就 是 说 ig 由 系统 进行 分 配 ， 不 由 用 户 指 定 ，is_visible 该 属性 决定 是 否 对 用 户 
# 可 见 ， 若 为 False， 用 户 看 不 到 该 值 。 


class Test (extensions.ExtensionDescriptor) : 























































































































@classmethod 
def get name (cls): 
return "Neutron Test Extension" 








@classmethod 
def get alias (cls): 
return "test" 








@classmethod 
def get description (cls): 
return ("test") 








@classmethod 
def get updated (cis): 
return "2012-07-20710:00:00-00:00" 














def get resources (seli 
exts = [] 

plugin = manager.NeutronManager.get | 
params = RESOURCE ATTRIBUTE MAP.get('tests', dict()) 

controller = base.create resource('tests', 'test',plugin, params, allow bulk-False) 
ex — extensions.ResourceExtension('tests', controller) 


exts.append (ex) 


— 
. 








plugin () 


















































return exts 


11.4.2 SARA 


编辑 完 代码 之 后 需要 重启 Neutron Server 服 务 。 


#screen -list 

There is a screen on: 

1197.stack (Detached) 

1 Socket in /var/run/screen/S-stack. 
#screen -r 41197 





A 





切换 到 q-svc 的 screen， 重 新 执行 如 下 命令 : 









































/usr/bin/neutron-server --config-file /etc/neutron/neutron.conf --config-file /etc/neutron/plugins/ml2/ml2 conf.ini & echo $! »/opt/stack/status/stack/q-svc.pid; fg || echo "q- 


查看 是 否 生成 了 plugin.pyc 文 件 ， 如 图 11-22 所 示 。 


[stack&control m12]$ 11 






































total 420 

drwxr-xr-x 2 stack stack 84 Oct 11 23:14 common 
-rw-r--r-- 1 stack stack 3459 Oct 11 22:45 config.py 
-rw-r--r-- 1 stack stack 2331 Oct 11 23:08 config.pyc 
-rw-r--r-- 1 stack stack 13859 Oct 11 22:45 db.py 
-rw-r--r-- 1 stack stack 12561 Oct 11 23:10 db.pyc 
-rw-r--r-- 1 stack stack 40146 Oct 11 22:45 driver api.py 
-rw-r--r-- 1 stack stack 46937 Oct 11 23:08 driver api.pyc 
-rw-r--r-- 1 stack stack 9085 Oct 11 22:45 driver context.py 
-rw-r--r-- 1 stack stack 10721 Oct 11 23:14 driver context.pyc 
drwxr-xr-x 8 stack stack 4096 Oct 11 23:14 drivers 
drwxr-xr-x 2 stack stack 142 Oct 11 23:14 extensions 
-rw-r--r-- 1 stack stack D Oct 1i 22:45 — imt .py 
-rw-r--r-- 1 stack stack 137 Oct 11 23:08 — imt .pyc 
-rw-r--r-- 1 stack stack 43129 Oct 11 22:45 managers.py 
-rw-r--r-- 1 stack stack 40843 Oct 11 23:14 managers.pyc 
-rw-r--r-- 1 stack stack 5262 Oct 11 22:45 models.py 
-rw-r--r-- 1 stack stack 4476 Oct 11 23:10 models. pyc 
-rw-r--r-- 1 stack stack 79562 Oct 12 09: 3] 
-rw-r--r-- 1 stack stack 48602 Oct 12 IT 
-rw-r--r-- 1 stack stack 3012 Oct 11 22:45 README 

图 11-22 生成 新 的 blugin.pyc 文 件 

11.4.3 测试 

获取 token 的 命令 如 下 : 

把 获取 的 toke 填 入 下 面 的 Token: 的 后 面 ， 然 后 执行 该 命令 : 

说 明 : 确认 IP 地 址 及 端口 能 够 正常 访问 。 

执行 完 之 后 会 在 启动 终端 看 到 类 似 如 下 的 信息 : 





eutron.plugins.ml2.plugin 














q-0e23ea9f- 


cb19-4c82-8184-e8f 


1b39cdfae 


admin 6225e5243e6e4a57b048c8400162e30f H 



































输入 如 下 命令 : 





neutron ext-list 





会 显示 所 有 扩展 组 件 的 相关 信息 ， 如 图 11-23 所 示 。 


[rootücontrol devstack]£ neutron ext-list 


Default Subnetpools 

Network IP Availability 

Network Availability Zone 

Auto Allocated Topology Services 

Neutron L3 ConEraur abfe external gateway mode 


default-subnetpools 
network-1p-avai labi lity 
network availability zone 
auto-allocated-topology 
ext-gw-mode 

binding 

agent 

subnet allocation 

13. agent scheduler 

tag 


Port Binding 

agent 

Subnet Allocation 
L3 Agent Scheduler 
Tag support 


external-net Neutron external network 
net-mtu Network MTU 

aval labi lity_zone Aval lability Zone 

quotas Quota Management support 
13-ha HA Router extension 


| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| | | 
| provider | Provider Network | 
| test | Neutron Test Extension | 
| multi-provider | Multi Provider Network | 
| address-scope | Address scope | 
| extraroute | Neutron Extra Route | 
| timestamp core | Time Stamp Fields addition for core resources | 
| router | Neutron L3 Router | 
| extra dhcp opt | Neutron Extra DHCP opts | 
| security-grou | security-grou | 
| dich agent schekiler | DHCP Agent ae He Ps | 
| router availability zone | Router Availability Zone | 
| rbac-policies | RBAC Policies | 
| standard-attr-description | standard-attr-description | 
| port-security | Port Security | 
| allowed-address-pairs | Allowed Address Pairs | 
| dvr | Distributed Virtual Router | 
一 - 


图 11-23 ”扩展 服务 列表 中 的 test 服 务 


输入 如 下 命令 : 





neutron ext-show test 





会 显示 test 扩 展 的 相关 信息 ， 如 图 11-24 所 示 。 


Irootücontrol devstack|£ neutron ext-show test 


links | | 
name | Neutron Test Extension 


-一 
| 
| + 
alias | test | 
| 
updated | 2016-10-28 | 

-一 


-一 

| 

一 

| = j 

| description | test 
| 

| 

| 

-一 


图 11-24 ”显示 扩展 test 细 节 


11.5 ”本 章 小 结 


本 章 首先 补充 了 OpenStack 拓 扑 及 Neutron 组 件 的 基础 知识 ， 然 后 主要 分 析 了 Neutron 的 架构 和 实例 的 数据 流 的 流向 ， 以 方便 读者 理解 Neutron 的 相关 概念 ， 接 着 分 析 了 Neutron 的 源码 结构 ， 并 做 了 
扩展 代码 的 实现 。 


第 12 草 “测试 反 术 


bug 修 改 完成 ， 要 保证 修改 的 bug 不 会 引出 新 的 pug。 新 功能 的 代码 修改 完成 后 ， 并 不 能 直接 提交 ， 需 要 进行 一 系列 的 测试 ， 测 试 没有 问题 之 后 才能 提交 。 本 章 介绍 一 些 Openstack 常 见 的 测试 技术 ， 
主要 围绕 DevStack 开 展 ， 包 括 单 元 测试 和 集成 测试 。 


12.1 OpenStack 测 试 基础 


Openstack 中 的 测试 可 以 分 为 以 下 类 型 。 
1. 单 元 测试 
单元 测试 (small test/unit test) 的 特点 : 
. 单元 测试 存放 在 每 个 组 件 的 代码 库 中 ， 例 如 ，Nova 的 单元 测试 放 在 novaVtests 目 录 。 
单元 测试 主要 是 针对 与 源码 级 别 的 测试 ， 测 试 的 是 函数 级 别 的 代码 。 
. 单元 测试 一 般 只 针对 于 public 级 别 的 函数 。 
2. 功 能 测试 
功能 测试 (medium test) 的 特点 : 
. 功能 测试 存放 在 每 个 组 件 的 代码 库 中 ， 例 如 ，Nova 的 功能 测试 放 在 novaVtests 目 录 。 
.和 单元 测试 相 比 ， 功 能 测试 要 基于 真实 的 依赖 环境 (数据 库 、 文 件 I/O 系 统 、Hypvetrvisot 等 ) 。 
3. 集 成 测试 
集成 测试 (large test) 工具 主要 有 以 下 几 种 。 
1) 集成 测试 工具 一 一 SmokeStack (基于 UI 的 集成 测试 工具 ) ， 获 取 网 址 为 https://wiki.openstack.org/wiki/Smokestack。 
2) 基于 Ruby 的 集成 测试 工具 ， 获 取 网 址 为 https://github.com/dprince/torpedo。 
3) 集成 测试 工具 一 一 Tempest， 获 取 网 址 为 http://docs.openstack.org/developer/tempest/。 
集成 测试 的 特点 : 
- 集成 测试 的 代码 放 在 独立 的 项 目 ( 如 tempest) Po 
- 集成 测试 要 运行 在 一 个 完整 的 部 署 环境 中 ， 如 一 个 完整 部 署 了 OpenStack 的 环境 。 
集成 测试 专注 于 系统 功能 、 完 整 性 以 及 和 真实 硬件 环境 的 集成 。 
- 集成 测试 代码 中 一 般 不 会 使 用 fake/mock。 
4. 界 面 测试 
社区 有 一 个 项 目 ， 是 针对 于 Horizon 的 界面 进行 自动 化 测试 的 ， 网 址 为 https://wiki.openstack.org/wiki/Horizon/Testing/UI。 界 面 测 试 (Ul test) 的 特点 : 
. 这 个 测试 工具 使 用 selenium 对 Horizon 进 行 了 集成 测试 。 
. 在 运行 测试 前 ， 要 先 启 动 OpenStack Servetr， 并 确保 Horizon 运 转正 常 。 
5. 性 能 测试 
社区 有 一 个 项 目 Rally， 是 针对 于 性 能 测试 (stress test/performance test) 的 ， 网 址 为 https://wiki.openstack.org/wiki/Rally。 
Rally 会 自动 部 署 一 个 OpenStack 的 环境 ， 并 运行 empest 来 验证 环境 。 
Rally 会 模拟 生成 用 户 负载 ， 以 观测 性 能 测试 问题 。 
Rally 通 过 Ceilomtet 来 收集 Hypervisor 和 VM 的 数据 ， 并 放 在 Rally 的 数据 库 中 。 
: Rally 最 终 会 生成 性 能 测试 报告 。 
6. 国 际 化 测试 
国际 化 测试 (globalization tests) 参考 如 下 : https://launchpad.net/openstack-i18n, 


: 国际 化 测试 会 测试 文字 翻译 是 否 可 以 正常 切换 ， 并 且 语 法 正确 。 


- 国际 化 测试 要 确保 文字 是 正确 编码 ， 并 且 符 合 不 同 语言 的 阅读 习惯 (如 阿拉 伯 语 是 从 右 向 左 的 阅读 习惯 ) 。 
7. 升 级 测试 


使 用 DevStack， 对 OpenStack 进 行 升级 测试 (upgrade test) ， 参 考 网 址 为 https://wiki.openstack.org/wiki/Grenade。 


12.2 早 元 测试 


单元 测试 主要 由 各 个 组 件 发 开 人 员 自 己 负责 ， 代 码 编写 完成 之 后 需要 做 相关 的 检查 ， 检 查 通过 后 再 提交 ， 防 止 直接 被 社区 拒绝 。 
run tests.sh 
以 Nova 组 件 为 例 ， 可 以 执行 如 下 命令 查看 测试 脚本 : 


#./run_tests.sh --help 
run tests.sh is deprecated and this script will be removed 
before the Mitaka release. All tests should be run through 
tox. 























To run style checks: 

tox -e pep8 

To run python 2.7 unit tests 
tox -e py27 
To run functional tests 

tox -e functional 

To run a subset of any of these tests: 
tox -e py27 someregex 
i.e.: tox -e py27 test servers 
Use following to replace './run test.sh -8' to do pep8 check with changed files 
tox -e pep8 -- -HEAD 

Additional tox targets are available in tox.ini. For more information 

see: 

http: //docs.openstack.org/project-team-guide/project-setup/python. html 

NOTE: if you really really don't want to use tox to run tests, you 

can instead use: 
testr run 
Documentation on using testr directly can be found at 

http: //testrepository.readthedocs.org/en/latest/MANUAL. html 
















































































简单 举例 如 下 : 


对 整个 项 目 进 行 py27 与 pep8 测 试 : 


#tox -e py27,pep8 


只 测试 pep8: 


#tox -e pep8 





对 libvirt 整 个 目录 用 例 进行 py27 测 试 ， 目 录 如 下 : 








/opt/stack/nova/nova/tests/unit/virt/libvirt 
#tox -e py27 nova.tests.unit.virt.libvirt 














对 test driver.py 文 件 中 的 所 有 用 例 进行 py27 测 试 : 








#tox -e py27 nova.tests.unit.virt.libvirt.test driver 





在 openstack/nova 执 行 test memory unlimited: 





#tox -e py27 -- nova.tests.unit.compute.test claims.ClaimTestCase.test memory unlimited 


在 openstack/swift 执 行列 表 测 试 : 











#tox -epy27 -- --tests test.unit.container.test backend:TestContainerBroker.test empty 
horizon 的 一 体 化 测试 : 


./run tests.sh --integration 


oor 


每 个 组 件 目 录 会 有 一 个 test-requirements.txt 文 本 文件 ， 运 行 单元 测试 会 生成 一 个 虚拟 环境 来 进行 测试 。 以 上 测试 会 创建 一 个 虚拟 的 Python 环 境 来 做 测试 ， 如 图 12-1 所 示 。 


[stack@control .tox]$ý cd py27/ 

[stack@control py27]$ 11 

total 0 

drwxrwxr-x 2 stack stack 49 Nov 4 19:50 bin 
drwxrwxr-x 2 stack stack 22 Nov 4 19:50 Include 
drwxrwxr-x 3 stack stack 22 Nov 4 19:50 lih 
lrwxrwxrwx 1 stack stack 3 Nov 4 19:50 libée4 -> lib 
drwxrwxr-x 2 stack stack 23 Nov 4 19:50 log 
[stackücontrol py27]$ pwd 

/opt/stack/nova/.tox/py2/ 


图 12-1 虚拟 环境 目录 内 容 


12.3 ”集成 测试 


集成 测试 主要 是 针对 Openstack 各 个 API 的 黑 盒 测试 ， 通 常用 于 功能 测试 ， 同 时 也 是 CI 的 基本 保护 网 之 一 ， 在 新 的 代码 变化 合并 到 master 之 前 每 个 有 效 的 Case 必须 都 是 “pass” 的 状态 。 
使 用 前 提 : 必须 先 用 DevStack 安 装 好 OpenStack， 且 保证 相应 服务 正常 启动 。 

Tempest 是 OpenStack 社 区 的 一 个 独立 的 项 目 。Tempest 是 随 OQpenStack 开 发 的 测试 套件 ， 能 够 对 OpenStack 各 个 service 进 行 全 面 测 试 。 
- Tempest 是 通过 nose 驱 动 的 ， 由 Python 语言 编写 ， 使 用 testtools 和 testtesources 等 几 个 测试 工具 库 。 

. 每 个 测试 可 以 分 别 测 试 JSON 格 式 和 XML 格式 。 

1. 目 录 结 构 分 析 

api: API 的 测试 集 。 

cmd: Openstack 的 命令 行 工具 测试 集 。 

common: 一 些 公 共 的 工具 类 和 冰 数 。 

scenario: 对 Openstack 的 常用 场景 进行 测试 ， 包 括 基 本 的 启动 VM、 挂 载 volumn 和 网 络 配置 等 。 

services: Tempest 自 己 实现 的 OpenStack API Client， 自 己 实 现 是 为 了 不 让 一 些 bug 隐 藏 在 官方 实现 的 Client 里 面 。 

stress: 压力 测试 集 ， 利 用 multiprocessing 来 启动 多 个 进程 来 同时 对 OpenStack 发 起 请 求 。 

tests: 测试 脚本 。 

2.run tempest.sh 

安装 DevStack 的 时 候 已 经 自动 配置 好 Tempest 配 置 文件 ， 配 置 文 件 在 如 下 目录 : /opt/stack/tempest/etc。 

配置 文件 为 tempest.conf， 如 果 Tempest 是 独立 安装 的 ， 则 可 以 这 个 配置 文件 。 

单独 运行 一 个 测试 用 例 : 


#./run tempest.sh -N tempest.api.compute.servers.test servers negative. ServersNegativeTestJSON.test reboot non existent server 





运行 一 个 包 下 的 case: 








#./run tempest.sh -N -- tempest.api.compute.flavors 





3.nosetests 
安装 过 程 略 (DevStack 已 经 自动 安装 ) 。 


测试 命令 : 





nosetests 





命令 执行 结果 如 下 : 

















Ran 0 tests in 16.889s 





1) 写 测试 文件 (测试 文件 命名 以 Test 或 test 开 头 ) ， 在 该 目录 下 执行 nosestests test filename, 


2) setup 和 teardown。 
setup: 在 测试 用 例 开始 时 被 执行 ; 
teardown: 在 测试 用 例 结束 后 被 执行 。 


进入 如 下 目录 : 








/opt/stack/tempest/tempest/tests 


目录 内 容 如 图 12-2 所 示 。 

这 个 目录 下 记录 的 都 是 相关 的 测试 文件 ， 读 者 在 编写 时 可 以 参考 。 

3) nosetests 常 用 的 命令 行 参数 : 
(sl 不 捕获 输出 ， 会 让 程序 里 面 的 一 些 命令 行 上 的 输出 显示 出 来 ， 如 ptint 所 输出 的 内 容 。 
--vi 查看 nose 的 运行 信息 和 调试 信息 。 例 如 ， 会 给 出 当前 正在 运行 哪个 测试 。 
(xD 在 第 一 次 失败 时 就 停止 执行 。 


[stack@control tests]$ Is 


base.py files test base test.py test list tests.py 

base.pyc . init .py test base test.pyc test list tests.pyc 

cmd _ anit .pyc test config.py test microversions.py 

common lib test config.pyc test microversions.pyc 

fake config.py negative test decorators.py test negative rest client.py 
fake confiad.pyvc README. rst test decorators.pyc test negative rest client.pyc 
fake tempest plugin.py services test hacking.py test tempest plugin.py 

fake tempest plugin.pyc stress test hacking.pyc test tempest plugin.pyc 


图 12-2 ”测试 文件 目录 


4) 测试 用 例 。 执 行 Tempest 所 有 测试 用 例 。 


test wrappers.py 
test wrappers.pyc 
utils.py 
utils.pyc 








#nosetests tempest 


执行 Tempest 某 一 个 测试 用 例 ， 如 identity 包 下 的 test tenants.py: 


#nosetests -vx tempest.api.identity.admin.v3.test users.py 








BY, 


#nosetests -vx tempest.api.identity.admin.v3.test users 





或 





nosetests -vx tempest.api.identity.admin.v3.test users.py:UsersV3TestJSON.test list user projects 





at 








nosetests -vx tempest.api.identity.admin.v3.test users:UsersV3TestJSON.test list user projects 





12.4 ”本 章 小 结 


本 章 以 DevStack 为 基础 讲述 了 在 开发 之 后 根据 需要 进行 OpenStack 测 试 ， 如 单元 测试 、 集 成 测试 等 。 


附录 A ”Mitaka 国 内 代码 贡献 


在 Liberty 版 本 中 ， 有 13 家 国内 企业 为 社区 做 了 贡献 ， 在 Mitaka 版 本 中 ， 这 个 数量 增加 到 了 15 家 ， 这 里 简单 将 这 些 企业 做 了 一 下 分 类 ， 如 表 A-1 所 示 。 


表 A-1 贡献 企业 分 类 


分 类 公司 名 称 
互联 网 用 户 AL. HR. MI 
电信 用 户 中 国 移动 


传统 IT 服务 商 | 华为 、 中 兴 、 华 三 


私有 云 服 务 商 | 海 云 捷 迅 、EasyStack、 九 州 云 、 北 乐 有 云 Feel BRS. UMCloud, 42s, Huron ( 休 伦 科技 ) 


1. 统 计 细节 

下 面 以 示例 说 明 各 公司 的 开发 人 员 和 开发 的 模块 。 

(1) 中 国 移动 的 社区 贡献 统计 

中 国 移动 的 社区 贡献 统计 如 图 A-1 所 示 。 

中 国 移动 的 社区 贡献 主要 来 自 Neutron 和 Ceilometer 两 个 项 目 ， 几 个 bug 修 复 都 与 Volume 相 关 。 

(2) 华为 的 社区 贡献 统计 

华为 的 社区 贡献 统计 如 图 A-2 所 示 。 

华为 的 主要 代码 贡献 集中 在 dragonflow、magnum、heat 等 模块 ， 特 别 是 在 dragonflow 上 ， 几 乎 全 部 是 华为 贡献 的 ，magnum 上 也 有 其 将 近 五 分 之 一 的 代码 。 
(3) 99cloud 的 社区 贡献 统计 


99cloud 的 社区 贡献 统计 如 图 A-3 所 示 。 
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图 A-3 99cloud 的 贡献 图 


可 以 看 出 99cloud 最 大 的 贡献 来 自 于 社区 文档 ， 而 在 项 目 方 面 的 贡献 则 主要 来 自 murano-dashboard、horizon、neutron 等 项 目 上 。 


(4) 海 云 的 社区 贡献 统计 
海 云 的 社区 贡献 统计 如 图 A-4 所 示 。 
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AAA 海 云 的 贡献 图 


海 云 是 一 家 在 国内 发 展 比 较 迅 猛 的 Openstack 早 期 创业 公司 。 贡 献 主 要 来 自 Neutron 相 关 的 项 目 ， 主 要 是 为 了 解决 项 目 中 出 现 的 实际 问题 所 做 的 努力 。 
Qs. 


以 上 统计 数据 来 源 于 http://stackalytics.com/ ， 可 以 根据 不 同 的 选择 进行 分 类 查询 ， 如 图 A-5 所 示 。 


STACKALYTICS D VendorDiverss A. Member Directory 


Project Type Module . Company A Contributor A Metric 






























































OpenStack Any module Any company Any contributor | Reviews 


图 A-5 分 类 查询 
2. 小 结 


Openstack 在 国内 已 经 发 展 多 年 ， 但 是 遗憾 的 是 ， 尽 管 我 们 拥有 较 多 的 开发 人 员 ， 但 是 对 社区 仍然 没有 话语 权 ， 国 内 的 用 户 需求 无 法 对 社区 上 游 形成 影响 ， 导 致 很 多 本 地 化 定制 的 需求 无 法 真正 在 社区 
版 本 代码 得 到 体现 。 所 以 如 何 让 中 国 的 声音 出 现在 社区 ， 是 所 有 Openstack 人 需要 思考 的 问题 。 


附录 B Newton 新 特性 


Openstack 的 Newton 版 本 是 由 309 个 企业 机 构 的 2581 名 开发 者 开发 的 。Openstack 基 金 会 希望 通过 Newton 来 改善 Nova、Horizon 以 及 Swift 的 向 上 /向 下 扩展 的 能 力 ; 面向 水 平 横向 扩展 Nova 计 算 环 
境 的 Cell V2 也 取得 进展 ; 增加 了 Heat 中 默认 的 融合 能 力 ; 改善 Ironic 中 的 多 租户 特性 。 


Newton 对 Cinder、lronic、Neutron 以 及 Trove 等 项 目 都 进行 了 升级 ， 具 有 高 可 用 性 。 此 外 Newton 还 在 安全 方面 进行 了 改进 : Keystone 的 升级 包括 PCI 合 规 性 以 及 加 密 证 书 。 
Openstack 还 改善 了 面向 运营 者 和 应 用 开发 者 的 易 用 性 ， 更 易于 设置 、 运 营 、 变 更 和 修复 ， 自 动 化 也 有 所 加 强 。 

Magnum 提 供 了 对 容器 调度 工具 Swarm、Kubernetes 以 及 Mesoso 的 配置 。Magnum 的 新 功能 包括 支持 可 插 拔 的 驱动 程序 ，Kubernetes 可 做 裸 机 服务 器 的 集群 ， 以 及 异步 集群 创建 。 
在 一 般 裸 机 配置 方面 ，lronic 增 加 了 多 租户 网 络 以 及 与 Magnum、Kubernetes 及 Nova 更 紧密 的 集成 ， 同 时 Kolla 现 在 也 支持 对 裸 机 的 部 署 。 

1. 改 进 的 可 扩展 性 


Newton 显 著 提 升 了 架构 和 功能 的 可 扩展 性 ， 包 括 跨 平台 和 地 域 的 向 上 或 向 下 扩展 能 力 ， 使 得 OpenStack 更 好 地 应 用 在 各 种 规模 的 云 计算 中 。 增 强 功 能 包括 改进 Nova、Horizon 和 Swift 的 向 上 /向 下 扩 
展 能 力 ，Cells V2 在 Nova 计 算 环境 之 外 的 水 平 扩展 ，lronic 的 多 租户 改进 等 。 


2. 进 一 步 增强 的 可 靠 性 
Newton 在 高 可 用 性 、 适 应 性 和 自我 修复 方面 的 优势 明显 ， 并 在 任何 工作 负载 时 都 可 进一步 保证 运营 的 稳定 性 。Cinder、lronic、Neutron 和 Trove 等 项 目的 高 可 用 性 也 得 到 了 提升 。 


Newton 在 安全 性 方面 也 有 所 改进 ,例如 ，Keyston 支 持 PCI 合 规 和 加 密 凭证 等 功能 升级 。Cinder 添 加 支持 重新 输入 加 密 未 加 密 的 卷 ， 反 之 亦 然 。 增 强 的 Cinder 特 性 还 包括 微 版 本 支持 ， 能 够 利用 级 联 功 
能 删除 带 有 快照 的 卷 以 及 多 个 实例 的 备份 服务 。 


3. 更 好 的 用 户 体 验 


Newton 使 OpenStack 成 为 虚拟 化 、 裸 机 、 容 器 的 统一 云 平台 ， 让 运营 者 和 开发 者 使 用 更 方便 ， 使 OpenStack 在 强大 的 自动 化 功能 下 更 容易 设置 、 操 作 、 改 变 和 修正 。Magnum 提 供 容 器 编排 工具 的 配 
置 ， 即 Swarm、Kubernetes 和 Mesos。Magnum 的 新 功能 包括 一 个 以 运营 者 为 中 心 的 安装 指南 、 可 插 拔 驱动 的 支持 、 裸 机 服务 器 支持 Kubernetes 集 群 和 异步 集群 的 创建 。 对 于 一 般 的 裸 机 配置 ，lronic 添 


加 多 租户 网 络 ， 更 紧密 地 与 Magnum、Kubernetes 和 Nova 集 成 ; kolla 可 以 支持 裸 机 。 


Kuryr 使 Neutron 网 络 可 以 支持 容器 ， 首 次 支持 Swarm 集成 和 Kubernetes 集 成 。Kuryr 的 另 一 个 亮点 是 ， 通 过 Magnum 和 Neutron (早期 版 本 ) 的 集成 可 以 支持 nest VM。 为 了 支持 流行 的 电信 网 络 配 
置 ，VLAN-aware VM 人 允许 用 户 在 OpenStack 云 上 运行 已 有 的 VNFs， 并 可 使 用 每 个 租户 的 VLAN 传 输 流 量 。Nova 增 加 了 可 变 的 配置 设置 ， 使 运营 者 能 够 重新 加 载 某 些 配置 参数 而 无 须 重启 节点 。 同 
时 ，Nova 的 get-me-a-network 简 化 了 网 络 配置 。 


Openstack 基 金 会 指出 ， 这 个 平台 可 以 运行 并 管理 几乎 一 切 系 统 ， 或 者 更 准确 地 说 ，“ 借 助 单单 一 套 API， 就 可 以 管理 裸 机 、 虚 拟 机 和 容器 编排 框架 。 
主要 的 新 增 功能 包括 : 
" 具有 经 过 改进 的 自 盒 合 功能 ， 可 以 跨 诸 多 组 件 实 现 高 可 用 性 ， 如 Cindet (RAH) ~ Ironic (IRE) ~ Neutron (虚拟 网 络 ) 和 Trove (数据 库 即 服务 ) 等 组 件 。 
Magnum 容 器 服务 现在 可 以 配置 三 种 容器 编排 工具 ， 即 Swarm、Kubernetes 和 Mesos。 
: Nova 现 在 可 以 扩展 到 更 大 的 规模 ， 更 擅长 横向 扩展 ， 还 能 够 更 轻松 地 缩减 规模 。 
. 在 安全 方面 进行 了 众多 改进 ， 例 如 ， 在 Cindet 中 为 未 加 密 的 卷 增添 了 可 重新 加 密 的 功能 (反之 亦 然 ) ， 对 Keystone 身 份 服务 进行 了 符合 PCI 安 全 标准 的 改进 。 


- Kuyt networking-for-docker4& 4F IA KE AM 


附录 C ”Ocata 版 本 新 特性 


1. 重 要 的 功能 


FilterScheduler driver 强 制 基 于 新 的 Placement API 做 调度 ， 现 在 必须 添加 [placement] 配 置 项 以 提供 资源 使 用 情况 ， 否 则 计算 节点 启动 不 了 。 目 前 Ocata 版 本 只 提供 了 CPU，RAM 和 硬盘 的 资源 使 用 
A ` AS 之 
验证 i 以 后 会 添加 更 多 。 


cell V2 为 Nova 默 认 配 置 ， 为 nova 提 供 更 好 的 可 扩展 性 。Ocata 版 添加 很 多 新 的 cell V2 的 功能 ,但 不 是 所 有 的 都 适合 生产 部 署 。 部 署 的 时 候 需 要 把 现 有 的 节点 作为 一 个 cell， 包 含 数据 库 和 消息 队列 连 
接 。0O 版 本 部 署 最 少 需 要 一 个 V2 的 cell。N 版 部 署 单一 的 cell V2 是 可 选 的 ， 对 于 O 版 ， 单 cell 下 V2 部 署 是 强制 性 的 。cell V2 的 架构 如 图 C-1 所 示 。 
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l nova-compute 
nova-api g message queue E 
nova-conductor 
nova-scheduler 


nova celll (Nova) 
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图 C-1 cell V2 的 架构 
计算 节点 分 成 了 很 多 小 的 cell， 每 个 cell 有 独立 的 消息 队列 和 conductor 服 务 。 
Ocata 版 本 添加 了 nova-status 命 令 ， 子 命令 upgrade 可 以 在 升级 前 检测 环境 是 否 可 以 升级 ， 发 现存 在 的 升级 问题 。 
placement API 负 责 主机 集合 间 的 资源 统计 和 分 配 ， 统 一 各 种 资源 类 型 的 用 量 ， 每 种 资源 表 添 加 了 uuid 字 段 来 匹配 resource_providers。 目 前 支持 VCPUs、RAM、Disk、PCI 设 备 和 NUMA 技 术 。 
Ocata 版 本 解决 了 共享 存储 下 资源 usage 统 计 出 错 的 问题 。 例 如 ， 使 用 Ceph 时 ， 每 个 节点 的 资源 统计 是 Ceph 整 体 的 资源 量 。 
2. 新 加 的 特性 
新 加 的 特性 如 下 : 
1) Ironic virt driver 使 用 configdrive 更 新 网 络 的 metadata。 这 里 的 metadata 包 含 的 网 络 信息 里 有 端口 组 和 关联 的 端口 ， 它 会 用 来 配置 |ronic 启 动 的 云 主机 的 端口 组 。 
2) 为 NUMA 技 术 和 hugepage 特 征 添加 AArch64 架 构 到 支持 的 架构 列表 里 。NUMA 需 要 满足 libvirt> 1.2.7，hugepage 需 要 满足 libvirt>1.2.8， 两 者 都 需要 QEMU 版 本 为 v2.1.0。 
3) 添加 OSProfiler 的 支持 ， 这 种 跨 项 目 分 析 库 允许 通过 OpenStack 服 务 支持 跟踪 各 种 OpenStack 请 求 。 
添加 以 下 版 本 swap volume 的 通知 : 
: instance.volume_swap.statt ; 
- instance.volume_swap.end; 


: instance.volume_swap.error. 


4) 支持 通过 nova-manage db archive_deleted_rows 命 令 实 现 数据 库 归 档 已 删除 的 行 。--until-complete 选 项 可 以 一 直 运 行进 程 直 到 没有 可 以 归档 的 行 。 

5) Virtuozzo hypervisor 现 在 支持 容器 的 临时 磁盘 。 

6) 支持 flavor 操 作 时 候 的 versioned 通 知 ， 如 create、delete、update access 和 update extra specs, 

7) Hyper-V driver 现 在 支持 以 下 的 额外 spec， 人 允许 为 每 个 云 主 机 的 本 地 磁盘 单独 应 用 MO 限制 。 

. quota: disk total bytes, sec. 

- quota: disk total iops, sec. 

以 下 cinder 的 前 端 qos spec 支 持 SMB cinder backend, 

: total bytes sec. 

- total, iops. sec. 

8) Hyper-V driver 使 用 os-brick 实 现 volume 的 相关 操作 ， 新 特性 如 下 : 

" 通过 光纤 传递 绑 定 云 硬盘 的 基础 。 

. 提高 iSCSI MPIO 支 持 。 

9) 为 ironic virt driver 添 加 故障 触发 转 储 功 能 ， 这 个 功能 需要 Ironic 服 务 支持 的 API 版 本 为 1.29 以 上 ， 同 时 需要 python-ironicclient>1.11.0。 

10) 为 ironic virt driver 添 加 软 重 启 功 能 ， 如 果 Ironic 下 的 硬件 驱动 不 支持 软 重 启 ， 仍 然 使 用 硬 重启 。 这 个 功能 需要 Ironic 服 务 支 持 的 API 版 本 为 1.27 以 上 ， 同 时 需要 python-ironicclient>1.10.0。 
11) 为 ironic virt driver 添 加 软 关 机 功能 。 这 个 功能 需要 |ronic 服 务 支 持 的 API 版 本 为 1.27 以 上 ， 同 时 需要 python-ironicclient>1.10.0。 

12) Virtuozzo hypervisor 支 持 libvirt 回 调 设置 管理 员 密 码 ， 需 要 libvirt>2.0.0。 

13) Xenserver 支 持 热 播 拔 虚 拟 网 络 接口 。 

14) 细 分 每 个 action 的 权限 控制 ， 以 前 的 权限 控制 向 后 兼容 。 

15) libvirt driver 添 加 了 live_migration_scheme 配 置 选项 ， 在 非 默认 状态 下 必须 先 配 置 live_ migration uri, 

16) 提供 了 详细 的 常量 支持 的 加 密 格式 (如 LUKs) 及 其 in-tree 提 供 者 。 这 些 常量 现在 应 用 于 识别 给 定 加 密 格式 的 加 密 程序 。 

17) 为 ironic driver 添 加 串 行 控制 台 支 持 。Nova 和 Ironic 都 要 配置 。 

18) 热 迁 移 现 在 支持 Virtuozzo 容 器 和 虚拟 机 ， 需 要 使 用 virt type- parallels, 

19) nova-status 文 持 OpenStack 的 新 装 或 者 升级 操作 ， 进 行 多 次 检查 准备 升级 。 

20) v2.40 微 版 本 为 usage 添 加 分 页 支持 ， 使 用 limit、maker， 不 带 limit 默 认为 最 大 值 ， 当 前 为 1000。 

21) 加 强 pci.passthrough_whitelist 对 正则 表达 式 语法 的 支持 ，“ 地 址 ”字段 可 以 支持 正则 表达 式 语 法 。 原 来 的 配置 仍然 有 效 。 

22) nova-scheduler 进 程 现在 调用 Placement API 以 在 调用 filters 之 前 获取 有 效 的 目的 地 列表 。 只 有 在 所 有 计算 节点 都 升级 O 版 本 才 可 以 ， 否 则 仍然 查找 数据 库 。 
23) 2.41 版 本 下 的 os-aggregates REST API 结 果 添 加 uuid 字 段 。 

24) V2 版 本 的 cell 添 加 新 的 主机 时 ， 必 须 运 行 nova-manage cell_v2discover_hosts 命 令 添加 到 cell。 设 置 scheduler.discover_hosts_in_cells_interva| 为 正 值 ， 调 度 程序 会 自动 处 理 该 任务 。 


25) Keystone 中 间 件 支持 当 服 务 token 和 用 户 token 一 起 发 送 时 ， 忽 略 用户 token 的 过 期 ， 方 便 长 时 间 的 操作 。 需 要 在 nova.conf 里 的 service_user 组 下 添加 服务 用 户 配置 ， 并 配置 
send service user token 为 True。 需 要 的 最 低 版 本 为 Keytone API version3.8, Keystone middleware version4.12.0。 只 用 于 Nova-Cinder 和 Nova-Neutron 的 API 交 互 。 


26) libvirt driver 下 ，vrouter VIFs (OpenContrail) 支持 多 任务 模式 ， 人 允许 通过 vCPU 数 量 来 提高 网 络 性 能 ， 需 要 创建 云 主 机 时 镜像 的 参数 设置 hw_vif multiqueue enabled 为 True。 

27) vendordata 元 数据 现在 支持 硬 故 障 模式 (hard failure mode) , api.vendordata dynamic failure fatal 使 用 该 配置 启用 (enabled) ， 实 例 取 不 到 动态 vendordata 则 会 失败 。 

3. 本 功能 涉及 的 改动 

1) nova 数 据 库 初始 化 时 在 compute_nodes 表 添加 uuid 字 段 。 

2) 修改 nova.objects.ComputeNode.create () 方法 ,创建 node 时 添加 uuid 字 段 ， 同 时 添加 一 条 记录 到 resource_providers 表 中 ， 并 向 inventories 表 中 添加 所 有 的 inventory/capacity 信 息 。 


3) 添加 nova.objects.ComputeNode._migrate_inventory () 方法 ,根据 compute_nodes 表 中 的 信息 初始 化 inventories 表 中 的 内 容 ， 如 果 没有 uuid 值 ， 会 自动 填充 。 当 一 个 旧 的 nova-compute 进 
程 把 序列 化 的 ComputeNode 模 型 发 送 到 升级 过 的 conductor 时 会 执行 nova.objects.ComputeNode._ migrate inventory () 方法 。 这 个 方法 也 会 在 resource_providers 表 中 为 计算 节点 创建 记录 。 


4) 修改 nova.objects.ComputeNode 模 型 ， 从 而 从 inventories 表 中 读 取 inventory/capacity 信 息 以 替代 以 前 从 compute_nodes 中 读 取信 息 。 


5) 修改 nova.objects.ComputeNode 模 型 ， 把 改变 了 的 容量 信息 (总 数量 、 最 小 单元 和 最 大 单元 限制 、 分 配 比例 ) 存储 到 inventories 表 中 以 替代 以 前 存储 到 compute_nodes 表 中 ， 并 从 inventories 
表 中 读 取信 息 以 替代 从 compute_nodes 表 中 读 取 信息 。 


4.Resource Providers-Allocations (资源 追踪 器 ) 

目的 ， 在 使 用 共享 存储 时 ， 要 确保 Nova 和 Horizon 能 正确 报告 usage 和 容量 信息 。 

PUT/allocations/(consumer uuid): 当 在 某 个 节点 上 创建 虚拟 机 或 者 迁移 虚拟 机 到 这 个 节点 时 调用 。 现 有 的 云 主 机 在 调用 update_available_resource () 方法 时 也 会 调用 。 
DELETE/allocations/(consumer uuid): 删除 虚拟 机 或 者 从 某 个 节点 把 虚拟 机 迁 出 时 调用 。 该 APIl 返 回 404 时 将 会 被 忽略 。 


generic-resource-pools (通用 资源 池 ) : 包括 服务 端的 修改 都 使 用 placement API 实 现 。 


这 些 请 求 在 ComputeNode.save () , Instance.save () 之 外 ， 在 child cell 的 compute_nodes 和 instance_extra 表 中 各 自 保 存 了 容量 和 usage 信 息 。 
N 版 本 计划 实现 资源 追踪 器 功能 ， 目 前 在 O 版 本 通过 placement APISCEI f VCPU, MEMORY MB, DISK GB, PCI DEVICE 这 些 资 源 的 追踪 。 

可 按 以 下 方式 处 理 各 种 资源 类 。 

1) 使 用 Instance.flavor.memory mb 和 vcpus field 处 理 MEMORY _MB 和 VCPU 资 源 类 。 

2) 处 理 DISK_GB 资 源 类 : 


当 计 算 节点 使 用 本 地 存储 作为 硬盘 或 者 从 云 硬 盘 启动 时 ， 使 用 总 量 是 flavor 的 root gb、ephemeral gb 和 swap 的 总 和 。resource_provider_uuid 是 计算 节点 的 uuid。 通 过 云 硬盘 启动 时 ，root_gb (R 
统 盘 ) 为 0。 


当 计 算 节点 使 用 共享 存储 并 且 不 从 云 硬盘 启动 时 ， 使 用 总 量 是 flavor 的 root gb. ephemeral gb 和 swap 的 总 和 。resource_provider_uuid 是 共享 存储 的 resource provider 的 uuid。 云 管理 者 为 共享 存 
储 池 创 建 resource provider 并 且 通 过 主机 集合 把 该 provider 与 计算 节点 关联 ， 之 后 资源 追踪 器 才能 知道 共享 存储 provider 的 uuid。 


如 果 pci_devices 表 中 有 把 云 主机 uuid 连 接 到 PCI 设 备 (连接 状态 为 ALLOCATED) 的 记录 ， 为 该 条 记录 中 的 dev_type of type-PCI 创 建 一 条 分 配 (allocation) 记录 。type-PCI dev type 标 示 出 一 个 通 
用 的 PC 设备， 现在 还 不 能 创建 更 复杂 的 PCI 设 备 类 型 来 对 应 SR-IOV 设 备 。 记 录 的 值 为 type-PCI 设 备 的 总 数 。 例 如 ， 如 果 一 个 计算 节点 上 的 云 主 机 连接 了 两 个 通用 PCI 设 备 ， 资 源 追踪 器 需要 
向 “allocations” 字 典 中 添加 一 个 要 素 : "PCI DEVICE": 2, 


本 功能 涉及 的 改动 : 
1) 通过 调用 placement http api 修 改 资源 追踪 器 创建 所 有 提 到 的 资源 类 的 分 配 记录 。 
2) 添加 完整 的 功能 集成 测试 ， 保 证 API 数 据 库 里 的 allocations 表 中 是 适当 的 数据 。 


5.Resource Providers-Base Models (基础 数据 库 模 型 ) 


resource provider: 保证 了 Nova 可 以 准确 追踪 和 保留 资源 ， 不 管 是 资源 、 一 个 单 计算 节点 、 一 些 共享 资源 池 或 者 某 种 外 部 提供 的 资源 。 例 如 ， 对 于 Ceph， 之 前 有 问题 是 因为 使 用 了 共享 存储 后 资源 使 
量 统计 有 误 。 


6.Nova STATUS 

下 面 是 Ocata 版 本 新 增加 的 一 个 API， 提 供 检 测 nova 部 署 状态 的 功能 。 
version: 15.0.0, 

nova-status« category» «action» [«args»] 
nova-status 命 令 提供 了 检测 Nova 部 署 状 态 的 程序 。 

Categories: upgrade nova-status upgrade 

upgrade 

接 下 来 会 详细 介绍 该 命令 的 使 用 。 


nova-status upgrade check 


在 有 新 的 代码 并 重启 服务 时 ， 进 行 检查 。 这 个 命令 需要 某 个 cell 内 的 完整 配置 和 数据 库 、 服 务 的 进入 权限 。 例 如 ， 在 这 个 检测 过 程 中 ， 也 许 会 检查 Nova API 数 据 库 和 一 个 或 者 更 多 cell 的 数据 库 。 它 也 会 
请 求 到 别 的 服务 ， 比 如 通过 Keystone service catalog 到 Placement REST API, 


返回 码 : 

0 代表 所 有 升级 准备 检查 顺利 通过 。 

1 代表 至 少 有 一 个 检查 出 现 问题 ， 需 要 进一步 调查 。 这 是 一 个 警告 ， 但 是 升级 也 许 会 成 功 。 

2 代表 有 一 个 升级 状态 检查 失败 ， 需 要 进行 调查 。 这 个 失败 会 阻止 升级 成 功 。 

255 代 表 发 生意 外 错误 。 

检查 历史 (15.0.0Ocata) : 

添加 cell V2 检 查 ， 命 令 nova-status upgrade check 可 以 在 命令 nova-manage cell_ v2simple_cell_setup 后 执行 。 

: 为 Placement API 添 加 检查 ， 例 如 ，Keystone service catalog 里 有 一 个 endpoint， 检 查 进行 时 会 对 这 个 endpoint 做 出 一 个 成 功 的 请 求 。 


该 命令 对 生产 环境 的 意义 : 运行 该 命令 可 以 提前 发 现 升级 是 否 会 失败 ， 并 做 好 处 理工 作 ， 方便 了 环境 的 部 署 升级 。 


附录 D  Gitf UB eap 


1. 远 程 仓 库 相 关 命 令 
检 出 仓库 : $git clone git://github.com/jquery/jquery.git. 


查看 远程 仓库 : $git remote -v, 


添加 远程 仓库 : 


$git remote add[name][url]. 


删除 远程 仓库 : $git remote rm[name]. 

修改 远程 仓库 : $git remote set-url --push[name][newUrl], 
拉 取 远程 仓库 : $git pull[remoteNamej]llocalBranchName]。 
推送 远程 仓库 : $git push[remoteName][localBranchName], 


2. 分 文 (branch) 操作 相关 命令 

查看 本 地 分 支 : $git branch, 

查看 远程 分 支 : $git branch -r。 

创建 本 地 分 支 : $git branch[name], 

注意 : 新 分 支 创建 后 不 会 自动 切换 为 当前 分 支 。 

切换 分 支 : $git checkout[name]. 

创建 新 分 支 并 立即 切换 到 新 分 支 : $git checkout -b[name]. 


删除 分 支 : $git branch -d[name], 


er 


-qd 选 项 只 能 删除 已 经 参与 了 合并 的 分 支 ， 对 于 未 有 合并 的 分 支 是 无 法 删除 的 。 如 果 想 强制 删除 一 个 分 支 ， 可 以 使 用 -D 选 项 。 
合并 分 支 : $git merge[name]。 

说 明 : 将 名 称 为 [name] 的 分 支 与 当前 分 支 合并 。 

创建 远程 分 支 (本 地 分 支 推送 到 远程 ) : $ git push origin[name]. 

删除 远程 分 支 : $ git push origin: heads/[name]. 


从 master 分 支 创建 了 一 个 abc5560 分 支 ， 做 了 一 些 修改 后 ， 使 用 git push origin master 提交， 但 是 显示 的 结果 是 “Everything up-to-date" ， 发 生 问题 的 原因 是 git push origin master 在 没有 track 
远程 分 支 的 本 地 分 支 中 默认 提交 的 master 分 支 ， 因 为 master 分 支 默 认 指 向 了 origin master 分 支 ， 这 里 使 用 git push origin abc5560: master 就 可 以 把 abc5560 推 送 到 远程 的 master 分 支 了 。 


如 果 想 把 本 地 的 某 个 分 支 test 提 交 到 远程 仓库 ， 并 作为 远程 仓库 的 master 分 支 ， 或 者 作为 另外 一 个 名 叫 test 的 分 支 ， 那 么 可 以 这 么 做 。 
提交 本 地 test 分 支 作 为 远程 的 master 分 支 : $ git push origin test: master, 
提交 本 地 test 分 支 作 为 远程 的 test 分 支 : $ git push origin test: test, 


如 果 想 删除 远程 的 分 支 呢 ”类 似 于 上 面 ， 如 果 左边 的 分 支 为 空 ， 那 么 将 删除 右边 的 远程 的 分 支 。 


$ git push origin :test 


oon 


刚 提 交 到 远程 的 test 将 被 删除 ， 但 是 本 地 还 会 保存 的 ， 不 用 担心 。 

3. 版 本 (tag) 操作 相关 命令 

查看 版 本 : $git tag。 

创建 版 本 : $git tag[name], 

删除 版 本 : $git tag -d[name]. 

查看 远程 版 本 : $git tag -r。 

创建 远程 版 本 (本 地 版 本 推送 到 远程 ) : $git push origin[name]. 

删除 远程 版 本 : $git push origin: refs/tags/[name]. 

推送 所 有 tag: git push origin --tags。 

tagitidibranch: 

git checkout tagname; 

git checkout-b new branch name, 

4.git stash 暂 存 相关 命令 

git stash: 备份 当前 工作 区 的 内 容 ， 从 最 近 一 次 提交 中 读 取 相 关内 容 ， 让 工作 区 保证 和 上 次 提交 的 内 容 一 致 。 同 时 ， 将 当前 工作 区 内 容 保存 到 Git 栈 中 。 
git stash pop: 从 Git 栈 中 读 取 最 近 一 次 保存 的 内 容 ， 恢 复工 作 区 的 相关 内 容 。 由 于 可 能 存在 多 个 Stash 的 内 容 ， 所 以 用 栈 来 管理 ，pop 会 从 最 近 的 一 个 stash 中 读 取 内 容 并 恢复 。 


git stash list: 显示 Git 栈 内 的 所 有 备份 ， 可 以 利用 这 个 列表 来 决定 从 哪个 地 方 恢复 。 


git stash clear: 清空 Git 栈 。 此 时 使 用 Git 等 图 形 化 工具 会 发 现 ， 原 来 stash 的 那些 节点 都 消失 了 。 

5.git rebase 使 用 

1) 当前 分 支 问 题 develop， 从 master 拉 取 最 新 代码 git pull--rebase origin master 或 者 git rebase develop。 
2) 将 develop 分 支 的 代码 checkout 出 来 ， 作 为 工作 目录 。 


3) 依次 修补 将 master 分 支 从 develop 分 支 创建 起 的 所 有 改变 的 补丁 。 如 果 修 补 补丁 的 过 程 没 问 题 ，rebase 就 完成 了 。 如 果 修 补 补 丁 的 时 候 出 现 了 问题 ， 就 会 提示 处 理 冲 突 。 处 理 完 冲 突 ， 可 以 运行 git 


rebase-continue 继 续 直到 完成 。 


如 果 不 想 处 理 冲突 ， 则 有 两 个 选择 ， 一 是 放弃 rebase 过 程 (运行 git rebase-abort) ， 二 是 直接 用 test 分 支 的 取代 当前 分 支 的 (git rebase-skip) . 


